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Dilwyn Jones 


Several important developments for the QL 
scene are taking place concurrently at the 
moment. The main one is no doubt the 
“TCP/IP” project in Switzerland. Jon Dent 
has made a point of keeping QL Email 
Mailing List members updated on progress 
and he has kindly written an article for us 
on this subject so that you can see that it 
really is happening and quite well advanced 
too. 

This in turn led Joachim van der Auwera to 
make ProWesS freely distributable. This can 
only be good - the fact that Prowess is free 
(although still Joachim's copyright) means 
that the improved windowing, scaleable 
fonts and HTML reader etc can offer a way 
forward for QL software such as Web brow- 
sers and Web page development tools in 
addition to bringing the concept of standard 
printer drivers closer for all. At first, | was 
worried this meant the end of ProWesS 
support and development, then he goes 
and proves me completely wrong by relea- 
sing a new version with improved Q40 sup- 
port. 

| am also aware of some software projects 
going on behind the scenes in relation to 
HTML page creation and so on - Geoff 
Wicks is building some support for HTML 
output into his QL2PC software and | have 
been working on a program called DOC2- 
HTML to allow basic Web pages to be cre- 
ated in Quill. Of course, we already have Jo- 
nathan Hudson's Lynx browser and email 
software which Jon Dent hopes to support 
with his software. | seem to recall that there 
is an ftp client software for QDOS too, al- 
though | cannot 


me right, there was also a version of the 
Mosaic browser for the QL at one time, 
though it never gained widespread use. 
The ‘colour drivers’ are continuing to deve- 
lop though so far only for the Q40. Better 
like this in my opinion - get them working 
properly first and then get them to work on 
the other systems. | gather that Roy Wood 
has lent an Aurora system to Tony Tebby in 
an attempt to assist with development, and 
work should definitely proceed on the QXL 
versions and the way prepared for QPC to 
join the rank of systems eventually enjoying 
the new GD2 facilities! 

Another cover disk with this issue I'm afraid. 
Rich Mellor has kindly supplied some demo 
versions of his software, Norman Dunbar’s 
assembler series provides some material 
such as an updated GWASL assembler and 
the latest QLTdis code. Although we were 
not exactly bombarded with modules for 
CueDark as we had hoped, we did receive 
some interesting submissions which are on 
the disk - we hope you'll help us select a 
winning entry. Apologies for having to ZIP 
everything on the disk, we ran out of space 
and felt it was a good excuse to get every- 
one using Archiver’s Control Panel (see 
Roy's article). 

All this progress and what do | do? 
Generate an article looking back at the 80s 
and 90s for QLers. Still, it was an interesting 
exercice for me and brought back some 
memories - nostalgia isn't what it used to 
be, as they say. 


[ErMojyIpA 


remember who 
the author is. 
This is not the 
first time QDOS 
has had access 
to the Web of 
course - uUQLx Mls 
users probably 
have that ho- 
nour since Jo- 
nathan Hudson 
made use of 
the underlying 
TCP/IP facilities 
of Linux via the 
uQLx emulator 
for his email 
software to 
gain access to 
the Web. If me- 


Good grief, they must have been 
more civilised than we thought 
in the 20th century - 
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ProWesS News from PROGS 

Joachim van der Auwera has decided to take 
ProWess, the PROGS windowing system, off the 
market to help the QL move on, and to make it 
freely distrioutable. While PROGS retain copy- 


right on the software, it can now be freely down- 


loaded from their Web site and used by QLers. 
Given the move towards better comms facilities 
on the QL and that ProWesS includes an HTML 
reader for example, this is definitely good news 
and will encourage use of the advanced facilities 
of ProWesS. Programming information for it is 
also available from sources such as Joachim’s 
Web site. ProWesS will be downloadable from 
the Web site 
http://www.triathlon98.com/Joachim/ 

in time, but until then users can download the 
files from the Triathlon98 anonymous ftp server 
ftp://triathlon98.com 

including programming information. 

On 13 February 2000 PROGS released a revised 
ProWesS version for Q40 users, including changed 
caching handling in the DLL manager to properly 
work on the Q40 (this requires SMSQ/E 2.94 or 
higher or compatible caching support); added a 
new mode 33 bitmap driver for the Q40 and 
support for mode 33 detection in the screen 
driver, startup file has undergone some minor 
changes (adding some extra pauses) to make 
loading work properly on the Q40. 


Simon Goodwin 

Congratulations to QL guru Simon Goodwin and 
partner Chris Lyle on the birth of their son Ingo 
Erin Lyle-Goodwin. Ingo was born on 15:06 on 
22nd February 2000, weighing 7 pounds 6.5 
ounces, after a long and rather difficult birth. 
Simon is in the process of moving house and 
has rather a lot on his plate at the moment. Any 
correspondence for Simon can be sent via his 
previous address in Oldbury and it will get redi- 
rected to his new home. 


Illness 

Our best wishes to Rich Mellor who has been 
unwell of late, and also to Bill Richardson who 
has spent some time in hospital recently. Best 
wishes to both for a full and speedy recovery. 
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MINIVIEW 

This is a new compact plain text file viewer by 
Dilwyn Jones, even smaller than the original text 
file viewer by the same author The version 
without QLiberator compiler runtimes is only 
about 7K long! 

ltis freeware and can be used for distributing 
text files such as instructions for software, or 
just used as a compact and ultra simple to ope- 
rate text file viewer It simply lets you load a text 
file and scroll through it using the cursor keys. 
There is a PRINT command to allow the file to 
be printed. 

If a filename is passed to the program as a com- 
mand parameter, the program loads and displays 
that file. This allows it to be used with Filelnfo for 
example. Otherwise, it prompts for a filename. 
MiniView will soon be available from PD libraries 
and from his Web site: 
http://www.soft.net.uk/dj/index.html 


uQLx NEWS 

The 28.1.00 release of the uQLx emulator from 
Richard Zidlicky has the following changes: 
USE_VM for Linux x86 and SPARC Solaris. 
Allows 12-20% speed improvement, | wonder 
who needs that in the times of GHz CPUs? This 
is very stable on Linux x86 2.0.35, but crashes 
Linux m68k 2.2.{6,10} (thus disabled for this ar- 
chitecture by default). 

Random changes to fs code to work around 
bugs in QDOS programs. 


ERGON Development 

Ergon Development have now released v2.24 of 
the Open World graphics conversion program as 
freeware. Along with Masterbasic 1.46 and the 
ZexXcel Spectrum emulator it is available for down- 
load from Ergon’s Web site: 
http://www.geocities.com/SiliconValley/Park/ 
6533/davideeng.htm 

Davide Santachiara is looking at organising an 
Italian QL meeting later this year possibly in 
September. 


Q40 NEWS 

pqivO11 is a picture viewer for the Q40 running 
under pointer environment. It requires SMSQ/E 
2.95 on a Q40. PCX, PNG, PIC and GIF files may 
be viewed. qiv012 is also an image viewer, but 
for command line and which doesn't need pointer 
environment. 

The Q40 web site www.q40.de includes the as- 
player sound player software for the Q40 and 
Jonathan Hudson's sox sound conversion util- 
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ties. Thierry Godefroy’s port of POV3.1q (Persis- 
tence of Vision) ray-tracer software. 

The Linux/QDOS classic CD-ROM is available via 
the online Q40 shop. 


Jonathan Hudson News 

Jonathan's Web site has moved - it is now on 
http://www.hedwig.uklinux.net/index.html 
Visitors to the previous address will be redirected 
after a short wait. 

In addition to the “sox” sound file conversion uti- 
lities for QDOS systems, Jonathan has now re- 
leased "Sound Toys’, a sound playing utility which 
plays all sox supported sound formats (requires 
the sox package though). 

Wxqt2 v0.06 is the 5/3/00 release of the gra- 
phical front end for qltools 2.14 and qxitool 1.13, 
which provides a graphical front end environ- 
ment for accessing QDOS formatted media 
(floppy and hard disk) under Unix or Windows 
systems. qxitoolii3 addresses a problem copy- 
ing files to/from the root directory on some 
Windows systems. 

QLynx was updated on 3/3/00. This is the SMS/ 
QDOS port of Lynx v2.8.2 broswer which pro- 
vides full internet/WWW access under the uQLx 
emulator Lynx can convert HTML to ASCII. This 
version requires Gold Card or better - preferably 
uQLx. 


TF Services 

SMSQ/E 2.95e Beta and QDOS Classic beta 
version P are now available, along with the 
Linux/QDOS Classic CD-ROM for the Q40. 
Work was progressing earlier this year towards 
release 1.99 of Minerva, which would add hires 
screen support under Aurora. 
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News from Dave Walker 

Dave Walker's Web site now includes the 6/2/00 
release of the C68 LIBC library in C68 for QDOS 
io fix a problem reported with scanf{) routines. 
There is also a Beta version of Discover v4.20 
that adds the ability to read CDROM drives at- 
tached to a Qubide interface, and a new release 
of the C68 Tool utility for use with C68 for QDOS. 
Dave's site is on 

http://www. itimpi.freeserve.co.uk/ 


QBranch 

QBranch have loaned Tony Tebby an Aurora ma- 
chine for colour driver development, stating that 
TT is already working on the development of 
SMSQ/E for QXL and QPC. QBranch and TF Ser- 
vices are looking into the feasibility of construc- 
tion of the GoldFire expansion previously planned 
by Qubbesoft P/D. 

QBranch have some of those rarities, ED disks, 
available for £15 for 10 disks. 

We have a couple of QXLs, Qubides Super Gold 
Cards and Auroras for sale. Qubides, QXLs and 
Super Gold Cards are pretty rare at the moment. 


ARCHIVERS CONTROL PANEL 4.00 

iS Now available from Thierry Godefroy. New in 

this release: 

® tar/gzip/bzip2/compress support added (these 
compression programs are also available from 
Thierry’s Web site) 

¢ New ‘tools’ sub menu allowing splitting of 
large files into several fragments 

¢ Extended configuration sub-menu 


QemuLator News 

Q-emuLator 2.0 for Windows 9x/NT is now availa- 
ble. It features a 640x480 full screen mode, very 
fast graphics. The QL display occupies most of the 
screen. You can also switch to 1024x768 full 
screen mode, where the QL display takes the 
whole screen. This is the slowest mode, due to the 
large amount of video memory used. It’s the only 
mode that emulates flashing in the QL 8 colors 
mode. Faster accelerated text output and block 
graphics. It is possible to specify a key to be auto- 
matically pressed at the initial QL F1/F2 prompt. 
Q-emuLator is shareware. This means that you can 
freely download a limited version of Q-emuLator 
and use it for two weeks to test many of its 
features and run your QL software (at limited 
speed). If you want to keep the emulator and 
unlock all the features, you buy a registration code 
that unlocks the program. Q-emulator can be 
downloaded from 
http://www.geocities.com/SiliconValley/ 
heights/1296/ 
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Just Words! Web Page 

Just Words! now has a web page at: 

niip:77 mMeniders.iripOd.co.ukK/GeoriwiCks/just ~ 
words.him 

This is a short and simple page to allow 
downloading of the demo versions of the 
program range. 


RWAP News 


A demo version of Flightdeck is now available, 
cost 2 pounds from myself. This has most of the 
features of the full version, except that flying time 
is limited to 10 minutes. 

| have now released v3.5 of Payroll and v3.5 of 
Cash Trader which will mean that any small/me- 
dium size business can now once again use the 
QL to run off weekly/monthly payrolls and keep 
its accounts (including VAT reports). These pro- 
grams cost 5 pounds each (either new or as up- 
grades from the original) or both can be ordered 
for 8 pounds. 

| have also now re-released QL Cosmos, a for- 
mer Talent astronomy program which allows you 
to display the position of the planets, stars and 
comets at any given time and date, from any- 
where on the Earth. You can simply move a cur- 
sor over one of the objects in the sky to get 
more detailed information. 

The SBASIC/SuperBASIC Reference Manual has 
now reached release 3. Each upgrade costs 6 
pounds each for approx 40 double sided A4 
sheets (or 10 pounds for 2 updates). Most of the 
Turbo Toolkit commands are now covered, inclu- 
ding some which have never before been docu- 
mented. 

lf you are uncertain which release of the manual 
you already have, please note that for Release 1, 
page | of the Contents is dated 10/1/98. Release 
2 and 3 have the release number shown on the 
footer of the Foreword pages. 

It is always worth updating the source disks - 
these cost 2 pounds. 

| can also supply the updated version of the DIY 
Toolkit series (3 DD disks) for 4 pounds. 


QCelt News 

We have now released a CD-ROM for the QL of 
Line Design clipart. Over 5,500 _LDP files for Line 
Design, nearly 600MB of clipart in total. This CD 
should be suitable for QL emulators which can 
make use of QXLWIN files fie. QXL, QPC, uQLx 
and recent versions of PC QemuLator). It is in 
[SO-9660 format. Regrettably the sheer quantity 
of clipart makes it impossible to make this 
available on other media. The price is £15 plus 
P&P 
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Regrettably, the QL emulators CD-ROM compila- 
tion has been delayed, it is hope to be available 


released, although please read the documentation 
as some authors may have placed minor 
restrictions on distribution of some programs 
included. 

We have also released an updated version of the 
Dilwyn Jones Bargain Bundle CD-ROM, which 
includes a couple of new freeware programs and 
corrects some errors in the documentation. The 
CD costs £25 or existing users can upgrade for 
£5, it is of course still available on 11 HD or DD 
disks for the same price. 

Q-Celt have also recently aquired a large quantity 
of high quality BLACK coloured PS/2 Keyboards, 
ideal for use on a PC (running QPC or whatever) 
to make it look more QL orientated! They also 
work with the Di-Ren keyboard Interface on a real 
QL with a PS/2 to 5 pin DIN adaptor fitted to the 
end of the keyboard connector - they are 
untested as yet on SuperHermes. They are IBM 
branded keyboards, brand new and boxed, 
originally retailing at £27.99 each. We have good 
stock, but are selling fast. We are selling them at 
£15 plus P&P about half price. 

We also have a quantity of second user lightly 
used ED disks for sale at £10 for a pack of 10. 
Anyone wanting larger quantities can contact 
Q-Celt to see if we can arrange a discount for 
larger quantities. 


News from Bill Richardson 

There are quite a few QLers who, with respect, 
we might refer to as the ‘old brigade’ looking for 
good old fashioned double density, or even high 
density twin drives as replacements. The pro- 
blems are that DSDD are no longer made nor are 
Extra Density (ED). Sometimes HD drives can be 
used with DD disks, but some don't and are often 
incompatible in a twin drive configuration. as they 
are designed without a Di D2 switch although 
this can sometimes be fixed, with a soldered link 
where there are pads to solder to on the circuit 
board. We have however just bought a quantity 
of TEAC high density drives which have not only 
got switches, but are compatible with double 
density and high density disks. 

Regarding extra densitywe have not been able to 
find them at all, and would be glad of any informa- 
tion on possible sources, and the same applies to 
discs although Roy Wood has found a few 
recently 

The shortage problem also applies to RGB 
monitors, although we still have a few left, so dig 
out such products you have passed by and make 
the ‘old brigade” happy. 
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Cover Disk Notes 


All files on this cover disk have been ZiPped 
because of the feature on Archiver'’s Control 
Panel. Have fun unzipping it all with Archiver's 
Control Panel - see Roy Wood's article. Once you 
have unzipped the various files, please read any 
accompanying _TXT or _DOC files. | suggest 
you LRUN the BOOT program first which will 
unzip one of the zip files of your choice (suggest 
you do Archivers Control Panel first). BOOT asks 
you to select one of the 14 zip files to unzip. 
STEP 1 
LRUN FLP1_BOOT 
STEP 2 
type in the number of the file shown on 
screen, from i to 14 
STEP 3 
enter the name of the drive containing the 
cover disk (e.g. FLP1_) 
STEP 4 
enter the name of the drive to unzip to (eg. 
PLP 2.) 


If you have a single floppy disk drive system, you 
can unzip to ramdisk (RAMi_ or RAM2_) first, 
then copy all of the files from ramdisk onto a 
blank formatted floppy disk afterwards. | suggest 
you use a Separate blank formatted floppy disk 
for the larger programs such as Archivers Con- 
trol Panel and the RWAP games demos. 


The files on the cover disk include: 


ACP4e00_zip 
Archiver's Control Panel v4.00 from Thierry 
Godefroy. 


UNZIP 

- youll need this to decompress everything 
on this disk! This is the Jonathan Hudson 
Unzip v5.32 for the QL. The full QL versions of 
Zip and Unzip may be obtained from 
Jonathan's Web site 

http://www. hedwig.uklinux.net/index.htmi 
The BOOT program calls UNZIP to 
decompress the zip files on the disk. 


GeeGraph_zip 
contains the listings from Herb Schaaf's Gee 
Graphics series. 


wolfboot_zip 
contains the "My Boot” article from QUioday 
Vol 4 Issue 1 
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The following files contain the entries from the 
various authors for the CueDark modules com- 
petition. Some include text file notes. 


Thierry_zip 
contain modules from Thierry Godefroy for 
CueDark, but at his request these are simply 
supplied on an ‘as is’ basis, not actual entries 
for the competition. 
Duncan_zip 
contains two sets of modules, one set for the 
Q40, the other for the Aurora. 
Stephen_zip 
contains entries from Stephen Poole - most of 
these run best on a 512x256 QL screen. 
Marcel_zip 
contains a ‘travelling through the stars’ saver 
module, very effective on QPC as you'd 
expect from Marcel Kilgus. 
Per_zip 
contains a puzzle-type saver from Per Witte 
Dietrich_zip 
contains a floating digital clock routine from 
Dietrich Buder 


INDEX4_zip 
contains a text file index for Volume 4 of QL 
Today. Index of Volume 1, Volume 2 and Volume 
3 along with back issues of previous cover 
disks can be downloaded from the Web site 
http://www.soft.net.uk/dj/index.himl 


Gwasl13_zip 
contains version 1.3 of George Gwilt's GWASL 
68008 assembler a more recent version of the 
program supplied on a previous cover disk. This 
version is better suited for use with Norman 
Dunbar’s Assembler programming series. 


QLTDIS3_zip 
contains files for the QLloday Disassembler 
project as part of Norman Dunbar's assem- 
bler programming series. 


MDP2_zip 
contains Al Boehm's MidiPlayer 2 program, for 
those wanting to control a MIDI synthesiser 
from their QL network ports. 


Flightdeck_zip 
A demo version (time limited) of the Flight- 
deck flight simulation software from RWAP 


DdayMkil_zip 
A demo version of D-Day Mkil wargame from 
RWAP 


2000 Hove QUANTA Workshop sss 


John Hall Cw 


The 4th Hove QUANTA work- 
shop was held on Sunday 
27th February at the Excel- 
sior Hotel on the Hove sea- 
front. 

The gathering for the tradi- 
tional pre-show Indian meal 
on the Saturday night was 
smaller than in previous years 
- just myself, Jochen Merz, 
Roy Wood, Roy's wife and 
their young daughter - and 
this was to an_ extent 
reflected in the turn-out at the oS 
show. For a mixture of per- C}M}MjMCc_ —r——h_err cc 
sonal and business reasons, ~ _ ~~ 
Rich Mellor (RWAP Software), 
Darren Branagh (Q-Celt Com- 
puting) and Dilwyn Jones (QL 
Toady editor) were unable to 
attend. Ron Dunnett, who 
wound up Qubbesoft at the 
end of 1999, was also mis- 
sed. 

Those traders who were able 
to attend comprised Jochen 
Merz (JMS), Roy Wood 
(QBranch), Tony Firshman (TF 
Services}, Geoff Wicks (Just 
Words!) and Bill (WN) Richard- 
son. As last year Enrico Tede- 
schi brought along his collec- 
tion of Sinclair rarities and 
oddities and there was also a 
strong QUANTA presence, 
with Bill Newell, John Taylor 
John Mason, John Gregory, 
Roy Brereton and Colin Bas- 
kett in attendance. Other QL 
notables who were around 
for all or part of the day were 
Jonathan Hudson {QTPI etc), 
Chris Cave (MView), Mark 
Knight (Knight Safe etc), 
David Gilham (PD Turbo 
Toolkit), Bruce Nicholls (ex- 
Quo Vadis} and Keith Mitchell 
(MinisQL). 

Tony Firshman spent much of 
the morning building and tes- 
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ting a Q40 system for 
Jochen Merz. | understand 
that Jochen plans to trans- 
fer his Bulletin Board Sys- 
tem, JMS-Box, onto it, 
which should be a good 
test of the reliability of both 
the hardware and the Q40- 
specific bits of SMSQ/E. As 
usual, Jochen was kept 
busy providing updates for 
his many programs, as well 
as promoting two new 
packages: Suqcess, a Poin- 
ter Environment. front-end 
to DBAS, and Agenda, a 
Lotus Organiser look-alike 
that comes in both Pointer 
Environment and ProWesS 
flavours. Once again, Roy 
Wood had the unenviable 
task of both manning the 
QBranch stand, with it's 
comprehensive selection of 
QL-related hardware and 
software, and co-ordinating 
the running of the work- 
shop. 

in the afternoon, Roy Wood 
and Tony Firshman gave a 
talk on the current state of 
the Q40, which included 
encouraging news on the 
progress of the SMSQ/E 
colour drivers, plus a short 
demonstration of the Q40 
Linux CDROM. Afterwards, 
Mark Knight gave a talk on 
his work on bug fixes and 
enhancements for Thee 
Editor formerly published 
by Digital Precision and 
recently released into the 
Public Domain by its author 
Chas Dillon. 


The pictures on this page 
were taken from Enrico 
Terdeschi's website with 
his kind permission. 
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The QL Family Tree - The 90’s 


Dilwyn Jones 


A look at the history of the QL from its launch in 1984 to the present day. 


1990 Ablex finally discontinued produc- 
tion of microdrive cartridges, but 


later in the year restarted production when 
further supplies of tape became available. Miracle 
Systems announces a new 20% faster Trump 
Card using 1MB DRAM chips. The Thor XVI 
remained available for a time from Dansoft and 
Thor International, while David and Penny Oliver 
of CST went to America to work, having “run out 
of money” to continue in Denmark. Thor Interna- 
tional closes down later in the year QL World 
moved to the Maxwell stable in April. QJump 
launched QPAC2, Minerva got multiple BASICs 
and ‘a new concept’ in QL software from Di-Ren, 
Fleet Tactical Command, allows multiple players to 
engage in a 3D naval warfare simulation on QLs 
over a network or modem. The same company 
launched a Micro Process Controller switchgear 
unit with switched relay outputs and driven from a 
parallel port. Di-Ren founder Robin Barker is cur- 
rently better known as the chairman of Quanta. 
Supplier PDQL in trouble as Miracle Systems and 
EEC Ltd start court action over unpaid debts. 
PROGS launch Data Design, a unique pointer 
driven database system for the QL, later to be- 
come fully programmable. Meanwhile, yours truly 
sets up in business under the name of DJC to 
supply software for the QL, and the same year 
Chris Boutal launches QL Genealogist which was 
to become one of DJC’s best selling programs as 
QL users take to researching family history in a 


big way. 
199 The first issue of the International 
QL Report is published by editor Bob 
Dyl sr in America. Qubbesoft P/D's Ron Dunnett 
sets up a new PD library service. Digital Precision 
proudly launch their new Perfection wordproces- 
sor (understating their software's names as 
usuall). A new QL group called NASA (!) is set up 
in Norway. The Amiga QDOS emulator is available. 
Level 2 drivers become available for the Super- 
QBoard and Trump Card, while Miracle Systems 
take the QL a giant step forward with the launch 
of the Gold Card, a 2MB 16MHz 68000 processor 
add-on card for the QL which boosts processing 
speed stag geringly. It also allows use of ED disks 
and drives for the first time. Though fast and with 
a capacity of 3.2MB (as opposed to 2.88MB on 
the PC) the disks are very expensive to buy and 
a little rare. Quanta takes over production of the 
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QIMI interface and Cowo Electronic in Switzerland 
and QLympic systems in Germany announce a 
limited edition of 50 ‘SuperQL’ machines based on 
Gold Card type QLs, later to be named the 
‘ExeQtor’. TF Services take over sales of Minerva 
from QView and advertise the Minerva MKIl after 
a period when the original Minerva was mostly 
sold by word of mouth and bulletin board. January 
1991 sees the first issue of the QL Hackers 
Journal - an e-zine for programmers by Tim 
Swenson, based in the USA. The C68 compiler 
becomes available, derived from PDQ-C adver- 
tised by PDQL but withdrawn by author Jeremy 
Allison, who removes the Lattice-C structures 
from it and the C68 we now associate with Dave 
Walker was born. 


1992 QL World moved to Headway Home 
And Law Publishing briefly in mid 
1992 then quickly on to a small publisher called 
Arcwind, whose most famous publication seemed 
to be a windsurfing and sailing magazine! Publi- 
sher Mark Kasprowicz had good intentions for QL 
World, which was still edited by Helen Armstrong 
as it had been for years. Grumbles appeared 
about TK Computerware at about this time and 
they eventually disappeared as far as the QL 
scene was concerned. Miracle Systems reduced 
the price of a Gold Card to £225 and sales went 
through the roof. Rumours abounded of a PC card 
from Miracle which would run QL software and of 
a new graphics card, and Digital Precision issued 
a new Gold Card version of Lightning SE which 
did away with the EPROM card because it could 
now run faster from RAM on the Gold Card. Ergon 
Development in Italy launched not one but two ZX 
Spectrum emulators running on the QL. Jochen 
Merz launched QSpread, the first serious alter- 
native spreadsheet to Abacus for QLers, and also 
demonstrated QDOS running on an ST-QL emula- 
tor with a 68030 processor card running at 
32MHz. The last major revision of Text 87, 
Text87Plus4, became available. A Quanta sub 
group (QLEA) released a clever little ROM swit- 
cher board which allowed your QL to switch bet- 
ween a Sinclair ROM and a Minerva giving users 
the best of both worlds - use a Minerva normally 
and switch back to a Sinclair ROM to run difficult 
old software or to test software on. Jurgen 
Falkenberg launches a new hard disk interface, 
the QL-HDD-Card. A new PD library service 
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HDD-Card. A new PD library service (Steve John- 
son’s SJPD) was launched and version 2.00 and 
3.00 of the C68 compiler became available, both 
in the same year TF Services launched the Her- 
mes, a much improved replacement chip for the 
old Sinclair 8049 co-processor in the QL which 
became a must for many people. EEC Ltd (Bill 
Richardson's company as it was then called) 
briefly sold an infra red cordless serial mouse 
system for the QL after Albin Hessler released 
the first QL serial mouse driver software. Di-Ren 
released their QL-PC Fileserver software, indica- 
ting a trend of greater influence of PCs on the QL 
scene. Iwo ZX81 emulators, Xtricator and Xtender 
became available plus a Spectrum emulator 
called Spectator by Dutch software author Carlo 
Delhez. In early 1992 Tony Tebby had outlined a 
strategy with Miracle Systems and Jochen Merz 
to make a QL compatible version of SMS aval- 
lable, a concept which would borrow ideas from 
Tebby’s Stella operating system in terms of modu- 
larity and so on - the project would come to frul- 
tion the following year QLem, a little known QL 
emulator for some models of Atari ST and Falcon 


is released. 
1993 Jurgen Falkenberg launches the 
QL2000 repackaged QL system 
based on a Gold Card QL and QL-HDD-Card 
system. Miracle Systems launch the QXL, a PC 
card using a 68EC040 processor chip with up to 
8MB of RAM and a QL compatible network port. It 
is planned to use the SMSQ operating system 
from Tony Tebby and a derivative BASIC called 
SBASIC. Long delays and frustration are caused 
as it takes months for the full SMSQ to appear 
Later, after some frustration on the part of Tony 
Tebby about what happened to the earlier SMS-2 
which was never intended to be sold for the QL, 
he creates SMSQ/E and SBASIC (which unlike 
SMSQ for the QXL has built in Extended Environ- 
ment and unlike SMS-2 has a BASIC interpreter) 
for all platforms including QL, QXL and Atari ST- 
QL. CGH Services’ Richard Alexander finally quits 
as a QL trader in March 1993, having been a soft- 
ware publisher PD library service and QL maga- 
zine publisher for many years. Ergon Develop- 
ment in Italy release the ZM/hT code compiling 
fast Spectrum emulator which actually compiles 
Z80 code into 68000 code for faster execution, a 
real advance in emulation technology. Psion and 
Dansoft finally give permission for QL/Thor 
Xchange and the original QL Quill) Abacus, 
Archive and Easel to be essentially freeware for 
the QL scene, although this does not cover the 
PC versions. Bruce Nicholls launches QReview 
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magazine for the QL through his Quo Vadis 
Design company, while Qubbesoft announce the 
Fastnet network system for the QL, reckoned to 
be 10 times faster than the original QL network. 
Hints are also dropped that Qubbesoft may pro- 
duce an IDE hard disk interface for the QL. Ob- 
scure references to and rumours of a Tony Tebby 
Operating system called Stella circulate, although 
Stella itself would not become available to QLers 
during the 20th century at least. Qubbesoft re- 
surrect the original QJump QEP-Il EPROM pro- 
grammer, and this year sees the first ‘Miracle In 
Newport, first of a series of annual shows in the 


USA. 
199 4 Qubbesoft P/D release the Qubide 
IDE hard disk system for the QL. DJC 
finally ships Page Designer 3 after one of the lon- 
gest delays in QL software writing history! Miracle 
Systems launch the Super Gold Card early in the 
year with a 68020 processor 4MB of RAM, a built 
in parallel port, a “crash proof’ clock and more 
speed than had been seen on a QL this side of a 
QXL! After the delays of the QXL system soft- 
ware, the Super Gold Card comes as a breath of 
fresh air to QLers and proves to be the last of this 
type of expansion that side of the millennium. 
(The Ultra Gold Card and Goldfire were mooted 
later in the decade, but neither made it to market 
before the year 2000). Di-Ren launch the ill-fated 
System Amadeus, a token ring expansion system 
designed to allow peripherals to be daisy chained 
from the EPROM slot of a QL. The system pro- 
mised parallel ports, fast serial ports, DIY inter- 
faces, sound sampler and playback, but was 
eventually abandoned later in the year QL World 
finally closes with the May 1994 issue and IQLR 
(International QL Report) moves to fill the gap left 
by QL World's demise. The very last article in QL 
World was Linear Regression by AF Wilson, with 
an advert from yours truly on the back page, so it 
could be said | was the one who had to close the 
door and switch the light out on QL World. Not 
sure | want to be remembered for that though. 
Jonathan Hudson releases QTPI, a pointer driven 
communications program which was to have a 
huge impact in following years. SMSQ/E was 
released for QL and Atari, along with a version for 
the QXL. DV3 (the third standard of disk access, 
DV2 gave us ‘hard directories’, gave us access to 
PC formatted floppy disks from SMSQ/E}. The 
Level 2 Config specification is released. Much 
prompting persuades Norman Dunbar to write 
‘The PE Idiots Guide’ which by itself resulted in a 
mass move of QLers into using QPAC2 and the 
pointer environment. 
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199 5 DJC ceases trading, but out of the 

ashes spring three new software 
companies - QBranch (Roy Wood}, Quo Vadis 
Design (Bruce Nicholls) and Geoff Wicks, later to 
adopt the name ‘Just Words’. QReview magazine 
merges with IQLR, leaving Bruce Nicholls free to 
concentrate on software publishing. Eros Forenzi 
introduces the QSI standard speed tests for QL 
based systems. Digital Precision makes all its 
software available in one giant bundle for only 
£149 with on-disk manuals in a final push for sales 
before stopping advertising their QL software the 
following year Miracle Systems start to sell soft- 
ware - for a while. Di-Ren release a low cost and 
simple to install keyboard interface using pro- 
grammable logic chips. TF Services release the 
SuperHermes board, an enhanced Hermes with 
fast serial port, mouse and keyboard interfaces. 
Qubbesoft P/D release the QPlane, a buffered 
backpiane to fill the needs of the increasing 
number of people transplanting their QL systems 
into PC-style cases. Daniele Terdina releases the 
first QL emulator running on an Apple Mac, called 
simply QemuLator and proposes a PowerMac 
version. Simon N. Goodwin writes that he has 
become the first person to run QDOS on a 
50MHz 68060 Amiga accelerator using Amiga 
QDOS v3.23. Simon also produces the first QDOS 
audio CD player on Amiga QDOS. PROGS an- 
nounce that they are working on ProWesS - a 
completely new window manager system for the 
QL. Dennis Donahue documents for the first time 
how he made a CD-ROM of all the QL software 
he could find simply by creating a large QXLWIN 
on his hard disk and copying it onto CDR using a 
standard PC CD-Writer, but finds that QL software 
is too compact and he !s unable to fill all GOOMB+ 
he could theoretically get on a CD for use with his 
QXL! It would be 1999 before the first commercial 
QL software became available on CD (unless you 
count the Amiga Format cover CD in 1996 where 
Simon Goodwin compiled tens of megabytes of 
QL software for the Amiga QDOS emulator in 
1996). Qubbesoft Miracle Systems announced a 
new product called QXL-Gold which would allow 
a Super Gold Card to be plugged into a PC, but 
sadly the product does not become available in 
the end. The QXL is discontinued because of 
rising component prices and not because of the 
incorrectly rumoured worries about the European 
EMC directives. Nasta demonstrates a mono LCD 
screen running with a QL. Michael Klein proposes 
the development of Primus, a 19 inch rack moun- 
ted QL derivative for industrial environments. 
People start overclocking QXLs to make them 


12 


faster September sees a 486 software based QL 
emulator demonstrated at a German meeting by a 
young programmer, who is immediately signed up 
by Jochen Merz to produce what would later be 


called QPC. 
199 Geoff Wicks launches the first ever 
QL Thesaurus and Style Checker 
programs. lll health eventually forces Bob Dyl to 
cease publication of International QL Report. and 
Jochen Merz and Stuart Honeyball decide to start 
anew magazine called QL Today and a desperate 
search for an editor fails and they are forced to 
appoint this mad Welshman as editor of the Eng- 
lish version (there is a separate German edition). 
After more than a year’s work, PROGS of Belgium 
finally launch ProWesS, the new Window Manager 
system for the QL. Qubbesoft release the Aurora 
replacement motherboard incorporating en- 
hanced graphics capabilities, though it was to be 
some time before SMSQ/E supported the en- 
hanced display resolutions and indeed the next 
century before the higher colour modes were 
supported. Qubbesoft are supplying 135MB col- 
lections of software on E2135 cartridges for 
Qubide users. QPC1 is launched. Quanta sells out 
of the first batch of Super Gold Cards made after 
Miracle discontinued the product. Miracle relaun- 
ches the QXL as the QXL2 with a 25MHz 
68EC040 processor and Terry Harman goes one 
better and recounts his experience of over- 
clocking one to 80MHz! Simon Goodwin permits 
Qubbesoft P/D to supply the entire set of disks of 
the long running QL World series DIY Toolkit to be 
supplied at PD library rates for the first time. TF 
Services and Bill Richardson decide to make 
available the serial to parallel printer converter 
interfaces once more. Wolfgang Lenerz releases 
an SBASIC interface for ProWesS. SJPD released 
the first QL encyclopedia on disk (or 3 disks 
rather). Based on the Probert Encyclopedia, it 
was freeware! Richard Zidlcky was working on a 
QL emulator for Unix/Linux systems, called uQLx, 
after testing 68000 emulation on the QLem emu- 
lator running on STonX on a Sun Sparc system 
and proving himself wrong that a successful 
68000 emulation in software would not be 
possible. Richard bases his work on Daniele 
Terdina’s QemuLator source code. SERNET is 
released, developed from Midinet, this allows a QL 
network style connection via serial ports bet- 
ween PCs, Ataris, QLs etc. 4 years later people 
were still struggling to get the cabling right! 
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1997 Miracle Systems enter into an 

agreement with QBranch, allowing 
QBranch to handle all sales of Miracle products, 
including the remains of the second batch of 
Super Gold Cards made by Quanta. SJPD an- 
nounce their closure in January 1997, then stages 
a welcome return a few months later QL Today 
issues its first cover disk (| think the honour of the 
first QL magazine to have a cover mounted disk 
went to QReview in 1994 or 1995). Simon Good- 
win (where would the QL scene have been with- 
out him over the years?) wrote that it was now 
possible for QDOS/SMSQ software to take ac- 
vantage of hardware floating point units using 
some code written by George Gwilt - although 
the first QL type hardware to use FPUs was the 
somewhat rare "Thor 21" years previously. QLay 
emulator (its 68000 emulation code is derived 
from UAE, an Amiga emulator by Bernd Schmidt 
and others) is launched, along with a PC version 
of QemuLator towards the end of the year A lot 
of QL hardware is announced during this year 
(Ethernet Card, Sound Card, Goldfire, bidirectional 
parallel ports, Ultra Gold Card) which never 
actually makes it to the marketplace! Quo Vadis 
Design closes as a software retailer but Bruce 
Nicholls plans to continue to be active in the QL 
scene - he goes on to set up the now popular QL 
Users Email Mailing List. The Manchester QL user 
group sell Pandora - a custom built black steel 
case to house QL systems. TF Services release 
SuperHermes Lite version of their existing Super- 
Hermes. Nasta generates a lot of interest with in 
depth articles on multiprocessing. TF Services 
announce the RomDisq, designed by Miracle 
Systems, a tiny 2MB or 8MB flash memory card 
for the QL which simply plugs into the EPROM 
slot of a QL. Rich Mellor announces that QBranch 
will sell his opus magnus, the first QL route finder 
software, an application which users had been 
almost begging to get on the QL for some time. 
QLay becomes a Windows 95 version, probably 
the first QL emulator on a PC to run in its own 


window, not a DOS box. 
199 8 Rich Mellor sets up in business as 
RWAP Software. Digital Precision al- 
low work to begin on updating some of their old 
software such as the Turbo Toolkit, work which 
keeps Mark Knight, David Gilham and others out 
of mischief for a couple of years. People worried 
about the impact of the ‘millennium bug’ on QL 
systems are surprised to discover that in fact our 
equivalent will in fact happen in 2029 or 2097 
depending on whether our systems use signed 
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time counters or not. QBranch and TF Services 
join forces to launch the MinisQL, a cased Aurora 
system using laptop sized Epson computer 
cases, allowing integration of a Gold Card, Hard 
disk and so on. Richard Zidlicky’s uQLx emulator 
handles the highest resolution screens yet for a 
QL type system - 8192x4096 - although I'm not 
sure where he found a monitor to display this 
resolution! Bruce Nicholls sets up the QL Users 
Email Mailing list, reflecting the growing number of 
QLers who use PCs or other computers in 
addition to QL and derivative machines. Although 
the QL has had a presence on newsgroups for 
some time, this is the first such forum organised 
via simple email, making it easier for many people 
with some form of access to email only to join in. 
Francois Lanciault announces Paragraph, the first 
pointer driven wordprocessor for the QL, based 
on the ProWesS engine. Jochen Merz announces 
the Milan computer as the next QL compatible 
system but no version of SMSQ/E becomes avai- 
lable for it and the machine seems to quietly dis- 
appear from the QL scene. QL scene has to face 
up to how to handle the Euro currency symbol. A 
very rare entity, a badly written QL virus program 
makes a brief appearance at a Quanta show that 
year, proving that we are not 100% immune from 
this curse. Rich Mellor completes the SBASIC/ 
SuperBASIC Reference Manual - a massive 1,000 
page reference guide to QL BASIC. Quanta take 
great pride in reporting that a large forecast 
deficit in their accounts had in fact been over- 
turned thanks to drastic cost cutting measures by 
the committee. Work by Jonathan Hudson and 
Richard Zidlicky mean that the Lynx browser 
running on uQLx on a Unix system can now 
access the underlying Unix IP sub-system to 
access the internet. In plain English, that means 
uQLx became the first QDOS platform where you 
could access email and the Web. QLCF set the 
ball rolling on colour drivers by contributing hard 
cash to Tony Tebby. SJPD finally closes ist 
August this year Amstrad issue permission to 
distribute QL ROM images in Europe. The Q40 
system is finally pushed towards market, and 
Mark Swift works on porting Amiga QDOS to a 
form known as QDOS Classic Q40 as an OS for 
the Q40. TF Services launch the MPlane, a low 
profile backplane card designed especially for the 
MinisQL. Qubbesoft launch the version 2.00 
Qubide ROM, which allows Qubide users to 
access lomega ZIP drives. 
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1999 SJPD found a new owner, in Phil 
Jordan, who sets up The Library PD 
Service and Darren Branagh sets up Q-Celt 
Computing, proving it’s still possible to set up in 
business as a QL trader Sadly, Qubbesoft P/D 
ceases trading in December 1999. Jochen Merz 
releases QPC2, an enhancement of the original 
QPC long requested by users. Chas Dillon relea- 
ses sources for his former PDQL and Digital Pre- 
cision programs, including Turbo, The Editor and 
some business programs, sO some eminent QL 
programmers set to work to produce updated 
versions of these classic programs. Q40 now has 
a choice of three operating systems - QDOS Clas- 
sic, SMSQ/E and Linux (the latter thanks to Ri- 
chard Zidlicky). Q-Celt Computing becomes the 
first company to issue commercial QL software 
on CD-ROMs for those emulator users who can 
access QXLWIN structured media. The QL scene 
nearly loses a number of its traders in an accident 
prone trip from England to a show in Croatia - de- 
spite a potentially serious car accident, they re- 
turn to tell the tale with only a damaged Volvo as 
evidence. Work starts in Switzerland on a TCP/IP 
system for the QL. Sadness as one of the best 
known and longest established Quanta sub- 
groups (Bristol) calls it a day - this group was re- 
sponsible for the Bristol area Quanta workshops, 
among the most successful QL shows in recent 
years, though shows will continue to be held in 


the area from time to time. Giorgio Garabello sets 
up the Quantum Ring, an interlinked set of QL 
Web sites as QL presence on the Web takes off 
in a big way. Colour Drivers, or GD2 or Graphics 
Device Interface 2 to use an ‘official’ term for 
them, become available for the Q40 first. Club QL 
International quietly shuts down, a victim of falling 
membership due to the growth in online commu- 
nication. Simon Goodwin and Al Boehm bring out 
a QL Mii player done exclusively in software via 
QL network ports. Long time North American QL 
dealer Frank Davis hands over the reins to John 
R. Rish of Home Electronics Service in Texas, 
who becomes the QL’s man in America for the 
next century! The first QL JPG viewer is written 
by Dave Westbury - a program sorely needed 
now that the colour drivers are here. Great 
interest is shown in Tony Tebby’s Stella system 
thanks to a virtually single handed campaign by 
French QL user Arnould Nazarian. And just when 
we thought we were having a good year the 
Quanta committee embarks on a proposal that 
Quanta should open its doors to other computer 
users and become a multi platform user group. 
Views are mixed, though most agree that action 
is required to stem falling membership even if this 
is a bit too drastic a way of going about it. Jochen 
Merz becomes the first QL trader to set up a 
Secure Web Transactions service, allowing QL 
goods to be bought over the Web. 


Of Webs Echoes Leaps and 


Surfing Black Boxes 


J. Dent 


munication over the Internet is 
possible. The protocol, which 
was used for the transmis- 
sion, is known as UDP That's 
short for user datagram pro- 
tocol. The datagram is the 


During November of 1999 
unnoticed by the rest of the 
world a datagram echoed 
through the Internet carrying 
the message ‘QL forever’. A 
small step for a datagram but 
a quantum leap for mankind. 
Well perhaps not quite for the 
whole of mankind but at least 
for the kind of man (or woman 
for that matter) who prefers 
his little black box to one of 
those Pentathion things or 
whatever they're called these 
days. 

What I'm referring to is the 
first test transmissions using 
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the TCP/IP stack I'm develop- 
ing for the QL and its deriva- 
tives. We are told that the 2ist 
Century will see practically 
everything connected to the 
net: telephone, TV central 
heating, cooker, fridge, wash- 
ing machine or whatever 
turns you on, or perhaps 
more to the point whatever 
you may wish to turn on, off, 
up, down or adjust, have ser- 
viced etc... It would have been 
a shame if the list did not in- 
clude the QL. 

The QL isn't going to be left 
out. The tests prove that com- 


whole packet of data, which is 
transmitted through the Inter- 
net. It includes the original 
user data in this case "QL for- 
ever’ and IP and UDP header 
information. The IP header in- 
formation includes the Internet 
address of the destination 
computer and of the source 
computer, in this case the QL. 
The address of the source 
has to be known by the user. 
The address of the QL is 
allocated by the ISP (Internet 
Service Provider) and may 
well be different every time 
you dial up. The IP header 
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also indicates the length of 
the data being transported. 
The UDP header contains the 
number of the port on the 
remote computer and the 
number of the port on the QL. 
The number of the port on 
the remote computer de- 
pends on what application 
you want to use on that com- 
puter For instance to get it to 
echo the "QL forever’ mes- 
sage back to the QL you 
need port 7. The QL port can 
be allocated by the user, auto- 
matically by the TCP/IP stack 
or by the programmer of the 
application running on the QL. 
Its actual value is not that im- 
portant so long as it is unique, 
Le. no other program running 
on the QL at the moment 

Is using this port 
number. 

For the above 
test the appli 
cation IS a 
simple —_pro- 
gram — which 
allows the 
user to enter 
the address of 
the remote 
computer, the 
port of the 
target applica- 
tion and the 
port number 
on which the 
QL will be lis- 
tening. A sepa- 
rate, receiver, pro- 

gram requires the 
same port number to be 
entered and will print any 
UDP messages received from 
the Internet destined for this 
port. A message, like ‘QL 
forever’ (what else) can now 
be entered in the first QL 
program and lo and behold it 
appears in the screen of the 
receiver program. It has been 
sent to the local ISP his 
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computer has checked the 
address and sent it onto the 
appropriate part of the Inter- 
net and maybe handed from 
one network to another until it 
arrives at the destination 
computer The ECHO applica- 
tion on this computer has 
received the datagram copied 
the "QL forever’ message 
to anew datagram, swap- 
ped the destination and 
source addresses, 
swapped the port 
numbers and sent 
it off in the 
other 
direction. 


This is the 
simplest type of protocol for 
use on the Internet, it is now 
running on the QL and it Is an 
important protocol but the 
most important protocol is 
TCP TCP stands for Transmis- 
sion Control Protocol. Where- 


as when you send a UDP 
datagram onto the Internet 
you have no idea if it arrives 
at the other side, if you send it 
by TCP then TCP will ensure 
that it arrives repeating it if 
necessary. If all TCP attempts 
to transfer the data fail then 
you are warned. 
TCP is used for transferring 
files, World Wide Web pages 
and most data where integrity 
Is more important than speed. 
UDP can be used for appl- 
ications which themselves 
deal with the question of inte- 
grity. For example in the 
ECHO application the arrival 
of the echo back at the origin 
confirms its successful trans- 
mission. Applications requiring 
the transmission of live sound 
Or pictures are well served by 
UDP’s — simpli- 
city and 
speed. They 
gain no advan- 
tage from the 
reliability — of 
TCP A repea- 
ted block of 
such data will 
arrive too late 
and is of no 
use. 
I'm working on 
AGP now. 
About 60% of 
the coding is 
done. There are 
application pro- 
grams running on 
UQLX the QL emulator 
for UNIX computers 
using the TCP/IP stack of 
the UNIX operating system on 
which the emulator is running. 
These include Lynx a browser 
for the World Wide Web and 
e-mail handling programs. 
So get ready to leap into the 
2ist century and take your 
black box surfing. 
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QD 98 £53.00 
QD + QBasic £69.00 
QD + Qliberator + QBasic £ 110.00 
Qliberator £50.00 
Master Spy v 3.3 £30.00 
QPTR £ 37.00 


1| £79.00 | 
| |Typset 94 £29.00] 
| |Fountext 94 £ 39.00) 
| 12488 drivers £ 29.00) 
| {Epson ESC/P2 drivers, 
£ 26.00 

| | Text 87 is the only QDOS | 
| /SMSQwordprocessor | 
j capable of handliing the | 

full screen on the Aurora 

@ §/QXL/ QPC systems. New } 
f drivers are SenHy : 


Easyptr pt 1 & 2 (together) £ 33.00 
Easyptr pt 3 (C library) £ 16.00 
QMake £18.00 
QMon /JMon £22.00 
Basic Linker £22.00 
| DISA3 £37.00 | 
\_ QMenu £ 16.00 


UTILITIES hy ae 3 ea 
ie £22.00 | / ‘Just Words' by Geoff Wicks | idan = om | 


QSup £32.00 
QSpread v2.04 £ 66.00 
Cueshell 2 £30.00 
Qload/Qref £15.00 
Disk Mate 5 £16.50 
QPAC 1 £ 20.00 
QPAC 2 £ 40.00 
QTYP 2 £30.00 
QLOQ £32.00 


|} THESAURUS, STYLE CHECK, SOLVITPLUS 3 
| £ 10.00 ea/ ANY 2 PROGRAMS £ 18.00 /ALL 3 PROGRAMS £ 25.00 | 
(Includes Pointer and non-pointer driven versions) 
( P.E. versions need Hot_rext, WMAN and PTR_GEN or SMSQSE to run ) 
Upgrades from previous versions £ 2.50 + S.A.E. New Manuals € 1.50 
QL2PC - New program !! 
f 
Convert text files from QL to PC formats upp , 
| and much more ! yim : 


Only £ 10,00 now vi 


Spelling Crib : PD program £ 1.50 +SAE 
or Free if you buy all three programs 


The colour drivers for the Q 40 are now at version 2.97 and the support 
disk for this has been changed a lot since it s issue. Please return your 
disks for upgrading (include return postage). 

While you are at it why not send off for a copy of ProWesS now that the 
base installation is free ! Look at the prices on the other page. You can 
now get LINEdesign with the free. ProWesS installation disk for only~ FPA. 00. 
and you can give Paragraph a whirl too ! 

It seems that Tony Firshman and-.I will be taking over the Gold¥iré ” “project 
now that Qubbesoft have dropped out. We may also be taking over tre 
Aurora and Qubide as well - more details in the next issue.” 

Now is a good time to upgrade your system to an Aurora because Tony 
Tebby is working on the drivers for that system. We still have a couple of 
these in stock if you want one and we may be building some more soon. 
Another new program is added to our list with SuQcess a great new 
database program. This will import Archive files and is very user friendly. 
Come and see it and the Q 40 at the Quanta AGM in Manchester in 
April 


“We > are currently out. ‘of ‘stock of the SuperBasic _ Reference. “Manual — a 
Place your order now to get one as soon as it is reprinted 

The SBASIC / SuperBASI C Reference Manual | Over 500 | 

| The complete definitive eure to BASIC programming in QDOS/SMSQ including | Pages! | 


three disks of PD toolkits, example procedures and an electronic index. | £ 40.00 
compiled by Rich Mellor, Franz Hermann and Peter Jaeger : 


+ postage | 
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| Tel +44 (0) 1903-200212 fax +44 (0) 1903-208070 


| email qbranch@qbranch.demon.co.uk web : hitp:/Aws3 .qbranch.demon.co.uk 
ps \ 


| O Branch 7 


Fe veling out on a limb ? 

Reach out for Q Branch. 
Suppliers of Quality ODOS/SMS@ products % 
Hardware and Soflware. 


Hardware | 
We have a small stock of second user items. Auroras} 
/ Qubides / Gold Cards / Qplanes / superHermes etc. | 
call us to get details of the items available. These | 


The Bank Volt, 6 Coronation Buildings 


Ham Road, Worthing. ee ply are going fast so call soon. 
__W. Sussex. BN11 2NN.UK. gow | o* super Gold Cards £ 125.00 
Fe" | QXL © Call 


ProWesS 


ProWessS (now free !) £1.60 


Recycled superHermes £ 80.00 * 
Recycled Gold Card £ 60.00 * 


DATAdesign £ 24.00 Recycled Aurora £75.00 * 
Fontutils £30.00 Aurora £90.00 
File Search £ 12.00 asene : sa 

plane ; 

ao mets Aurora cables £3.00 
Dilwyn's Fontpack E Call Aurorarom adaptor £3.00 
LINEdesign v 2.16 £ 24.00 '‘Arfa Braquet' £ 8.00 
PMN oe ‘Son of Braquet' £ 18.00 
Paragraph The 'Braquet £ 16.00 
MC plate £ 6.50 


The ProWesS word processor 
Demo version £ 1.50 + postage 
Full Registered version £ 18.00 


* when available. 
14" and 15" monitors for the ere Call. 


available now 


ession 2.02 Q Branch Pro ograms 
ii 
The Knight Safe 3 awver® £ 35.00 
upgrades from Ne ous versions £5.00 


SMSQ/E 


Gold Card / Atari / QXL Version 


Q - Route v1.08C ' £25.00 
Route finding programme g_sJON 
Ww 


Q - Count £ 25.00 


Pointer driven home accounting 


The Fractal Collection ! 


This is a brand new program which will produce stunning 
animated fractal patterns. It will run on anything from a 
Gold Card to the Q40 and will be capable of using the 

power of the colour drivers when they are released. 
Complete with many example files and routines to design | 
your own screens. | 


@ 
Various Atari versions : call for details 
The Colour Drivers are running on the Q Branch Q 40! 
Coming to a computer near you in 2000! 


| QPC 2 is here ! 
| £ 90.00 (£ 70.00 SMSQ/E Owners) 


Upgrades from QPC 1 £ 30.00 
(return master disk) 


, Special offer | 
\Get Cueshell for only £15.00 with any copy of SMSQ/ 


There are so many extras available for the Q 40 Q 40 board with 16Mb RAM & VO card £330.00 

that it is hard to list them here. if you are + SMSQ/E £ 30.00 

interested in one of these boards than contact us Extra 16 Mb RAM £ 30.00 

and we will supply the details. the basic prices are Tower Case £ 45.00 
_shown here. _ prices do not include shipping. 


We can accept payment by VISA, Mastercard and Switch. You can also pay by -— 
VISA | Eurocheques made out in Sterling or a Sterling cheque drawn on a UK Bank. 
| Prices include Post and Packing in Europe. 


be poteece eo} 
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Q 40 Tips 


Roy Wood 


The recent Eindhoven show provided a few hints 
and pointers for Q40 users. One of these con- 
cerned the use of MKPART_EXE the program 
that is used to create partitions on hard disks. 
First you should use v 1.02 of MKPART_EXE or 
later if it is available. Earlier versions have bugs 
which could cause problems later on. | have 
included this version with the current distribution 
disk and you should return your disk for a free 
upgrade if you do not have it. | have also expan- 
ded the notes for using it to make it easier 

One thing the documentation did not make clear 
is that the size of the QDOS partition is critical to 
the performance of the machine. If you have a 
large hard drive, | had a 1Gb when | first started 
out, and use it as one partition the slave block 
handling starts to slow everything down as you 
put more onto the disk. It is better to use a maxi- 
mum size of 256Mb to keep the machine perfor- 
ming well. The drives can be linked and unlinked 
from the system in the same way as the Qubide 
drives. If you use the WIN_DRIVE command you 
can set which partition is linked in with which 
drive indentification. The first partition is always 
linked in as wini_ as a default when SMSQ/E is 
Started but from there it is up to the user The 
format Is 

WIN_DRIVE WINn_, DRIVEn, PARTITIONn 

for example: 

WIN_DRIVE 2,0,1 

Create WIN2_ using the first Hard Drive and the 
second partition. 

WIN_DRIVE 3,1,0 

Create WIN3_ using the second Hard Drive and 
the first partition. 

Tony Tebby tells me that the ‘The BASIC Atari 
partition table (requested by Peter) has 4 entries. 
There are at least two extended partition tables 
but | do not know if any other system for the Q40 
would support them. 

This means that you can only create 4 partitions 
on a hard disk for use by SMSQ/E. If you use 
MKPART.EXE to create partitions of 256Mb as 
suggested on a drive larger than iGb the last 
partition will be forced into being of a higher value 
than the optimum suggested. 
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This is because you can set up a second hard 
drive as a slave. There seems to be no mecha- 
nism to partition a second hard drive from 
MKPART_EXE so it is better to set it up as a 
master and partition it before you link it in as a 
Slave drive. 

One other thing that has been causing a bit of 
confusion now that the Colour Drivers are finally 
reaching a wider public is the way they use the 
resolutions. | cannot recall seeing this documen- 
ted anywhere but it would seem that the lower 
resolution of 512 x 256 pixels does not use the 
colour displays at all. lf you move up to a higher 
resolution then the colour comands all seem to 
work you can use the commands. 

| also learned, at the Hove show, that ProWesS is 
very suspectible to which mode it starts in. If you 
load ProWesS in the 512 x 256 mode at the start 
of your boot file and then move the display to 
1024 x 512 the mode 33 driver is not linked in and 
the display is scattered across the screen. It is far 
better to start the system is a higher resolution if 
you want to use ProWesS. This is where the 
branching boot file comes in handy. You could 
offer an option of which display or set of pro- 
grams you need and then select certain proce- 
dures within the BOOT Alternatively make the 
ProWesS extensions load in a separate BASIC 
program and call that when the system is already 
in H-RES mode. 


Image Viewer PQIV 


Claus Graf 

There is a picture viewer program for the Q40: 
paiv. It uses the Q40's display modes with 65535 
colours, therefore it demands at least SMSQ/E 
2.95. At the moment it's possible to read and 
display the following image files: 

e PCX 

e PNG 

e PIC 

e GIF 

The program is written for the Pointer Environ- 
ment and can hopefully be used without a 
manual. Next step to do is the possibility to save 
pictures. That means that PCX, PNG or GIF files 
can be converted to PIC or saved as a back- 
ground image. Then you can load nice back- 
grounds on your Q40 with the SBasic command 
BGIMAGE. PQIV in the current version is free and 
can be downloaded from the Q40 Website 
http://www.a40.de. 
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Jpegs how to get some - or a review 
of a Kodak 215 zoom digital camera 


Bill Waugh 


Dave Westbury is working on 
software that should allow us 
to view Jpeg graphic files on 
Qdos and sms systems, | have 
an early version of Dave's soft- 
ware but as yet have not had 
time to try it, due in part to a 
recent 16 day holiday to the 
west coast of USA and a multl- 
tude of other commitments, 
isn't it amazing how. stuff 
comes along to fill any spare 
time that you thought you were 
going to have? 

| have been thinking of buying 
a digital camera for some time 
now but have been put off by 
the price of the ones with the 
best resolution or the poor re- 
solution of those that | found 
affordable, however the above 
mentioned holiday and _ the 
chance to purchase a Kodak 
215 zoom at a very good price 
gave me the incentive to bend 
some plastic, | don't want to go 
into detail as to where | pur- 
chased the camera but the 
words holiday and Walmart 
might give you a Clue, suffice 
to say that the price of the 
camera and an additional 16 
meg storage media was about 
£100 cheaper than you would 
pay at Dixons in Britain. 

Before | describe the functions 
of the camera let me say this, | 
was a bit concerned about the 
resolution. The most recent ca- 
meras on the market have 
resolutions in the order of 3 
megapixels and can cost up to 
a thousand pounds, the Kodak 
215 has 1 megapixels and can 
be bought at Dixons for £260 - 
of course you may get it 
cheaper or haggle a bit. 
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Is it good enough 
Kodak state that it will give 
photo quality on a printout of 
7x5 inches, | can say that this is 
accurate, | have printed some 
of the photos | took on an 
Epson 740 (fit to page) and 
they are excellent at 8x6, and 
the colour is amazing, so if you 
have been waiting for digital 
cameras to come of age then | 
would say you could buy now. 
lf anyone would like to see an 
example of a photo print out 
then | could send one out to 
you, bear in mind though that 
glossy paper is still about 50p 
a sheet and colour cartridges 
cost also, so a pound coin 
included with your name and 
address would be appreciated. 
The camera saves the images 
in Jpeg format or FlashPix, the 
supplied media is 4 megabytes 
and will hold 12 images in 
highest resolution 1152x864, 
and best Quality. 

Colour is 24 bit (millions of 
colours). 

Resolution can be set at 
1152x864 or 640x480. 

Best quality needs explanation, 
it really means the degree of 
compression, the more com- 
pression used some detail or 
colour will be lost so less 
compression = less pictures 
Stored but better detail kept in 
the pictures. 

| purchased a larger 16 mega- 
pyte media, it holds 62 images 
at high res best quality and 
came with a USB reader USB is 
a newish sort of serial port for 
PC and allows quicker down 
load of the images. 

The camera is quite neat in 
size, about what you would 


expect for a normal camera. 
The front has the telephoto 
lens (2x zoom), flash, view- 
finder, light sensor, flash sensor 
and an indicator for the self 
timer On top of the camera are 
four buttons Shuiter self timer 
close up (macro), and flash, also 
there is the status display, this 
indicates quality and resolution 
choice, battery state, flash type 
chosen, red-eye, cloSé-up, ca- 
mera memory card and self- 
timer. 
Viewed from the back the right 
hand side has a slide to release 
the battery cover while the left 
side has a door for the me- 
mory card and three rubber 
flap covered jack plug ports, 
the top one is the serial output, 
middle one is for an ac adapter 
and the third is video out. 
The back of the camera has as 
you would expect a Lcd dis- 
play, a power switch and next 
to it a status light, a slider to., 
select zoom, four scroll but- 
tons, a’ do it” button and a 
slider with the following posi- 
tions 
1. Capture - for taking pictures 
2. Review - for viewing pictures 
you have already taken 
3. connect for downloading pic- 
tures via a serial cable or 
video cable to view your 
pictures on a TV 
4, Preference - this is where 
you set the camera to your 
individual requirements. 


Taking pictures 

This is very much point and 
click, the camera does it all for 
you although there is the faci- 
lity to set exposure to con- 
stant should you wish to take a 
series of images with the same 
exposure setting. Flash - can 
be altered to one of five types 
1. Auto - default 

2. Fill - always on 

3. Red-Eye - eliminates the same 
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4, Fill + Red-Eye 

5. Off Exposure - as mentioned 
the exposure can be locked to 
give a consistency it can also 
be altered from -2 to +2 in 5 in- 
crements an increase of 1 dou- 
bles the amount of light al- 
lowed into the camera. 
Preview - you can select to 
preview your image before you 
take it, this does consume bat- 
teries, also available is "Quick 
preview’, the image is dis- 
played for a few seconds after 
being taken this allows you to 
delete and retake the image 
again should the inevitable 
thumb before lens syndrome 
strike. 

Templates - there are templates 
on the supplied media and you 
can choose to add a template 
to pictures taken, these how- 
ever can not be removed once 
selected, there are no tem- 
plates on the third party media | 
bought. 

Date - you can date stamp your 


pictures. 
Image type - select between 
FlashPix or Jpeg 


Displaying pictures 
Computer - software is sup- 
plied for Mac or PC to display, 
enhance, store and print ima- 
ges, as the camera has a Serial 
link hopefully we might get 
someone to show us how to 
download them onto our 
Qdos/Smsq based systems. 
TV - a cable is supplied that 
connects to a video port on a 
TV (jack plug type), after selec- 
ting an AV channel pictures can 
be displayed one at a time or 
as a slide show with each pic- 
ture displayed for 5 seconds. 
TV output is selectable bet- 
ween PAL and NTSC. 

You may have gathered from 
this review that | am pleased 
with this camera, while it may 
not have a resolution that 
allows for A4 printout this is not 
something | will miss very often 


and | am more than happy with 
the suggested print size of 7x5. 


It would also have been nice to 
have been able to fit a different 
lens at sometime but the range 
of the supplied zoom Jens is 
really quite adequate. 

| have no interests with Kodak 
Eastman and have written this 
review with the sole aim of 
informing QL Today readers 
that if like me you have held off 
from buying a digital camera 
because you are worried that 
they are still developing and 
your purchase might prove dis- 
appointing in a years time then 
take a look at them now, the 
mid range priced ones might 
just be what you require. 


fl can fully agree - | bought a 
second-hand Olympos with si- 
milar specs, 13 million pixels, 
and the results are preity 
good - Jochen] 


Archivers Control Panel 


Roy Wood 


In the last issue | wrote a short guide to Filelnfo Il. 
| feel | should follow this by giving you another 
guide to the Archivers Control Panel. This pro- 
gram is a boon to those of you who, like me, can 
never remember strings of command letters to 
get zip and unzip to work. This is compounded 
by the fact that there are several other compres- 
sion programs available to us and each of these 
uses a different set of commands. The Archivers 
Control Panel takes the pain out of that and 
makes zipping and unzipping archives simple. 
Yes you guessed it - it is another one of Thierry 
Godefroy’s little gems and tt is free! 


System Requirements 

Anyone can use this program provided they 
have a system with Toolkit 2 (Tk2) available, The 
Pointer Environment and enough disk space to 
the archiving files they need to use. | have put a 
basic system onto a DD disk and ran it on a 
Trump Card so there should be no difficulty there. 
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lf you want to be able to use all of the Archiving 
programs you will need to either have ED drives 
or be prepared to swap disks to get access to 
the programs although ACP itself is very small. 
Hard disk users, of course, have no problems. 


What you get 

The ACP zip file itself contains only three files: 
ACP_HELP 

ACP_OBJ 

QLIB_RUN336mod 

You will also need Richard Zidlicky’s Signal 
extensions (sigext30_rext) to be LRESPR'd if you 
want to make use of the latest version of INFOZIP 
ACP_HELP Is a text file which can be viewed in 
any of the normal text programs such as QD, 
EDITOR, QUILL etc and contains all the instruc- 
tions you will need to run and use this program. 
The same file is called upon when you click on 
the '?’ symbol in ACP and it opens in a separate 
window so you can view the help file whilst 
working. It is not in HTML format so you cannot 
jump from subject to subject but it is short and to 
the point. | would advise that you print it out if 
you are new to the program since it does give a 
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very good guide to using it. 

ACP_OBJ is the program itself This is a basic 
program which has been compiled using the 
QLIBERATOR compiler It was created using Albin 
Hessler's Easyptr toolkit. 

QLIBLRUN336mod are the Qliberator runtimes. 
These are needed to get the program to run and 
should be LRESPR’d before starting the program. 


You should also have the Pointer environment 
files (PTR-GEN, WMAN, © and | 
HOT_REXT or SMSQ/E) running. It . 
does make use of Jochen Merz’s 
menu extensions (MENU_REXT) so . 
load that if you have it. If you do not ; 
then the program will still run but you = 
will have to select files by typing them 
in by hand. 


Getting Started. 

OK first problem. You have ACP_ZIP 
and you have UNZIP_ZIP how do you 
get started? Well if you have 
UNZIP540.bin you can just LRESPR 
the file at the command line and then 
follow the prompts. There will be a 
pause while it extracts itself to start - 
and then a box will appear which asks. : 
for the directory for temporary files (| : 
suggest RAMI_) and then a directory ° 
to extract to (| suggest RAM2_). The 
reason for using the RAM disks for this is that if 
anything goes haywire during the extraction you 
Stand little risk of corrupting your hard drives File 
Allocation Table and you can easily reset the 
system and clear out the unwanted bits having 
extracted the files and copied them to disk. It will 
then ask you to run a short basic file called 
SFX_BAS. Do this and it will extract the whole 
archive to RAM2_. This will give you the UNZIP 
program that you can use to extract ACP itself | 
did experience some problems doing this under 
SMSQ/E v 2.91 on the Super Gold Card but it 
extracted fine with standard QDOS / Minerva. 
Once you have unzip on a disk (assume flpi_) 
you can copy the ACP_ZIP file to it and then use 
the command: 

EX FLP1_UNZIP ;'FLP1_ACP_ZIP -d RAM1_' 

This should extract the files to RAM1_ and you 
can copy them from there to the final destination 
that you will use the program from. 
If you have already LRESPR’d the Pointer Envi- 
ronment, MENU_REXT and the Qliberator Run- 
times all you need to do is EXEC the program 
and off you go. 
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44 Temporary directory $4 


44 ACP configuration J 


: Sort filenames in the current director 


Configure It 

Before we can get started, however we must 
first configure the program for our own system. | 
have created a subdirectory called Archivers and 
in there are all of the compression and de-com- 
pression tools. ACP can be configured by using 
the standard CONFIG program supplied with 
most PE. programs. It can also be configured by 
Menuconfig, the more sophisticated version 
provided with most of Jochen Merz's Software. 

z There are three 
- config blocks to 
' deal with The 
© first is directly in- 
; volved with the 
» program _ itself 
«and contains it 


Confiquration 


find its help file, 
which is the de- 
fault directory to 
look in for com- 
pressed files (| 
have created a 
subdirectory 
called downloads 
where | put all 
files downloaded 
. from the BBS or 
other sources), 
which directory to start at for uncompressed files 
and a few other items like this. Among the items 
which are configurable here are whether the pro- 
gram should use Fileinfo if present, whether ACP 
should retain its currently settings when you quit 
it, and which should be the default archiver. 
The configuration of this part of ACP affects the 
way that you use it so apply some thought here. 
It is worth setting the program to save its config 
to the environment variables on exit because 
that means if you have to retrace you steps it will 
Still point to the same directories. It is also worth 
turning on the sort routines because it is easier 
to find files which are sorted into alphabetical 
order | would suggest that you set the default 
archiver to ZIP because that is the most common 
file format you will use. Setting it to use Filelnfo I 
can be either a blessing or a curse depending 
on how you are using it and how you have set 
up Filelnfo I. More of this later 
The second config block deals with the different 
archive formats and where to find their programs. 
this is very important because the program can- 
not use a particular compression program if it 
cannot find it. 
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The last block is the advanced settings. These 
allow you to let the archivers anticipate and fix 
program errors. Leave these turned on unless 
you find that they get it wrong. 


The Program. 
OK it is configured - let's go! 


Aechivers Control Panel 
y4 88 ¢c) 1992-1999 Thierry Godefroy, 


ACP .help 
ACP obj 
GL ib wunsdénod 


§ diamonds -> 
F DOC -> 

¢ DOWNLOADS =) 
e EMACS -> 

i FILEINFO ~> 
& label -> 

| MYPROGS -> 


The first impression on seeing ACP is how similar 
it looks to the Filelnfo il configurator Thierry has 
used a similar colour scheme to that used on the 
Configurator so the two programs look very 
similar The top left corner has three icons for 
‘MOVE’, ‘HELP’, ‘SLEEP’ and ‘EXIT’ all familiar 
from Filelnfo ll. Then we have a program banner 
with the name of the program and the that of the 
author as well as the version number The top 
right corner has a further four windows. 
‘OPTIONS’ will call up a menu which will allow 
you to add extra settings to the command line. 
You can set it to do a few things such as 
overwrite files with same filename or force the 
result into QDOS format. The most important of 
these will be turned on already but you can 
experiment with them to get a feel for their uses. 
‘ACTIONS’ comes next. This menu will allow you 
to allow you to perform tasks with the selected 
archive. These include checking the archive to 
ensure it is a valid file and getting the statistics 
on any or all of the files in the archive. 

‘CONFIG’ is an ‘on the fly’ version of the second 
config block and allows you to make temporary 
changes to the programs configuration. 

The last item is a drawing of a screwdriver. This 
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represents Tools and allows actions specific to 
the BZIP GZIP and compress formats. It will allow 
you to split large archives over several disks. 
Beneath this is a line which is labelled ‘Current 
Archiver’. This indicates the type compression 
you are using at the time. If you are extracting 
files from an archive this wil affect the extension 
that the program 
looks for and which 
archiver it uses to 
display the directory 
of that archive. 
Under this is ano- 
ther line of windows. 
the first has arrows 
pointing downwards 
and indicates that 
the window beneath 
it is the current ar- 
chive. Next come a 
series of com 
mands: 

‘ALL’ will select all 
of the files in the 
current archive (if 
there is one) 
‘EXTRACT’ well ex- 
tract selected files 
in the current ar- 
chive. You can se- 
lect files in the ‘Archive File’ window by HiTting 
them. If you ‘DO’ this without selecting any of the 
files in the window below it will first offer a 
window for you to enter the names of the files 
you want to extract. If you do not enter anything 
here it will then extract all of the files to the 
current default. If you ‘DO’ this without a filename 
in the Archive Window an error is generated. 
‘ADD’ will add files to the selected archive. As 
with the EXTRACT’ option if you highlight files in 
the ‘Current Directory’ window it will add them to 
the current ‘Archive File’, but unlike ‘EXTRACT’ it 
will not try to add all of the files in the ‘Current 
Directory’ window to an archive. 

‘ALL’ Will allow you to do this. 


Lets Archive! 

At a basic level using Archivers Control Panel is 
simplicity itself The next four windows in the 
display do all of the work. The two narrow win- 
dows display the file names that you are working 
with and the two larger windows beneath the 
files in the directory or archive. 

To start with let us UNZIP a file. This process is 
very simple indeed especially so if you have 
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loaded the menu extensions. If you have set ZIP 
to be the default you can start right away with 
this month's cover disk. 

Go to the long narrow window beneath the 
‘Archive file’ label. You can either ‘DO’ (left click) 
the window and get a flashing cursor which will 
allow you to type in the file name, or ‘HIT’ (right 
click) it which will call up a menu_rext window 
and allow you to select the file from a list. Once 
you have selected the _zip file to be worked on 
the list of files in that archive will appear in the 
box below. If the box stays blank you have not 
loaded the signal extensions. If you want to ex- 
tract all of the files in that archive you need only 
‘HIT’ the window marked ‘All (or press ‘a’ on the 
keyboard). All of the files in this window will be 
highlit. If you only want to extract one or two of 
the files you can select them by going to the list 
window and ‘HIT’ting the files you want to ex- 
tract. These files will become highlit and they are 
ready for extraction. 

If you want to view any of the files in the archive 
just ‘DO’ the file in the list and a window will ap- 
pear displaying the file's contents. If you have 
other files highlit in the window they will be 
displayed one by one in the order they are listed 
in the window. This is useful if you have a 
README.txt file in it and you want to read the 
text before you extract the files in order to make 
sure that you only extract the files that you need. 
Just ‘DO’ the file name in the list and you can 
read it. 

Once you have settled on the files you want to 
extract go to the narrow window on the right 
side of the program's screen. This indicates the 
destination or where the files should be unzipped 
to. Again you can ‘HIT’ and get the 
flashing cursor which allows you to 
enter the destination directory or 
device that you want to use. Far 
easier to let Menu_rext do the 


As soon as the the archiver (in this case UNZIP) 
starts to work you will get a window appear 
which reports the progress of the extraction. If 
you wish to stop this at any time click on the 
‘GUN’ icon in the top left corner and the process 
is terminated. The last file in the list may be 
incomplete so you should check this if you wish 
to keep it. 


VICE VERSA 

OK now let's do it the other way around. Maybe 
you want to zip up all of your letters into an 
archive so you can keep them on a floppy disk. 
‘DO’ the narrow window on the right hand side 
and go to the directory where the files are or 
‘HIT’ it and type in its name. You should now see 
an alphabetical list of the files in this directory. 
The sort routine will only sort the name and not 
the type of the file so you may find that any 
sub-directories within that directory are inter- 
spaced with your files. These are marked by the 
symbol '-” after the directory name. 

Again you can select all of the files in this win- 
dow by clicking on the ‘All window or by pres- 
sing ‘I. You can also ‘HIT’ individual files as above 
to select files individually. 

You now need to enter a file name for the 
resulting ZIP archive. Go to the left hand narrow 
window and ‘HIT’ it. When you get the flashing 
cursor enter the name of the file that you want to 
create. If you do not add ‘_zip’ onto the name of 
the file ACP will do it for you. All you have to do 
now is to click on the ‘Add’ button and the ‘ZIP’ 
window will spring into life. 

Once you have your Archive you may wish to 
add a new file to it. With ACP this is easy. Just 


> ‘frchivers au Panel gd 


ruin “PROS ARCHIVERS_unzip;" WIN1_DOWNLOADS BZIP2="1.2ZIP # -d ram2_” 


work and ‘DO’ it to get the 

‘Directory Select’ which allows you |) innating: ranz-plockeoruc 
to select the menu from there. If |) yang: nmi 

you press ESC while you are in this pone merges 


window The program will default to oe 


the DATA default directory. The inflating: ran2_bzip2_c 


inflating: rom2_bzip2recover_c 


directory which appears in this inflating: ran2-bz! ib,h 
window by default is configurable in Dnatice cee haetlecacle 


the config block so you can set it ee 
to RAMi_ and unzip to a RAM disk 
- just remember to copy the files to 
a non-volatile medium before you 
switch off All that is left now is to 
click on ‘Extract’ and UNZIP will do 
its work. 
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rom? _manual, texi 
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load the directory of the file you want to add, 
highlight the file or files that you need to add. 
Then go to the ‘Archive File’ window and call up 
the Archive that you want to add it to. You should 
see the list of files already there in the window 
below. Once this is set up just click ‘Add’ or press 
‘d and the ‘ZIP’ program will appear and add the 
file to the archive. 
This is where the File- 
Info. «ol ~=—s compatibility 
comes in. Say you 
have a list of files that 
you want to archive but 
want to check a few 
things before making a 
final commitment. Just 
‘Do’ the filename and 
Filelnfo it will step in and 
perform the action that 
you have set Filelnfo il 
to use. This is where 
the ‘curse’ part of the 
use of Filelnfo comes in 
because if you have 
highlit several files and 
View catalogue then accidentally 
DO'ne one of them 
RN Fileinfo il will go on and 
do its work on all of the 
files. 
There is an added function here because Thierry 
provides a set of BASIC routines which allow you 
to delete files directly from the ACP window. 
Very handy to tidy an archive before ‘ZIP’ping. 
(You can also delete files from an archive by 
highlighting them in the Archive window and 
using the ACTIONS menu.) 


Hove files 


Freshen archive 


Delete files 


Of course sometimes you wind up ‘DO'ing when 
you should ‘HIT’ and Fileinfo Il gets launched 
when you did not intend it to be. Thierry has 
thought of this and added a config item that will 
ask you if you really meant to do this so you 
have a chance to abort the operation. 


MonoCall 


Nick Cheesman 


Not Only..... But Also 

The Archivers Control Panel is a very useful and 
versatile tool and no QL user should be without 
it. It is simple to use and can be launched on 
almost any QL system. Not only does it allow you 
to extract and create ZIP files but it also deals 
with other more obscure compression formats 
such as ‘tha’, tha’, ‘arc’, ‘zoo’, and ‘tar’. Recent 
changes to the program allow it to use the GZIP 
and BZIP compressors so there is practically no 
format it cannot extract from. 

Although the program itself is very simple to 
operate it has more complicated depths which 
the more advanced user can investigate and can 
fix errors generated by the common archivers. 
This has only been a brief dip into its use to get 
you started. 

With ‘Filelnfo If and ‘The Archivers Control Panel’ 
the QL has become a lot more powerful - ama- 
zingly enough they are both free too. | think all 
users should send a ‘thank you’ postcard to 
Thierry for such sterling work. 


for cash and even when 
Dixon's started selling QL’s at 
bargain prices, it was still be- 
yond my pocket. Then before 
you could catch your breath, 


The 1980's was a very exciting 
time for computer buffs like me. 
New machines coming out 
practically every month, each 
one better than it’s predeces- 
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sor The Spectrum was my first 
computer and | enjoyed using it 
but there were always other 
machines to tempt the wallet. 
Sadly | was always strapped 


the 1980's were gone and the 
PC came to rule supreme. It 
also meant that the QL sud- 
denly became very affordable 
on the secondhand market. 
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| bought my current batch of 
machines {four in all although 
one has a fault) several years 
ago for forty pounds complete 
with floppy drives, 512k of me- 
mory and a box of software 
that included Taskmaster, Flash- 
back and Spellbound. | have 
since added a few more inclu- 
ding Scrabble and the MSDOS 
emulator Solution. (| am keen to 
find a CP/M emulator if anyone 
has such a thing). All | need 
now is some QL World maga- 
zines and it'll be just like the old 
days again. 

lt was also about this time 
that | felt the need to publish 
a FanZine covering all 
manner of old 1980's kit 
now that official support 
had ended. | struggled for 
weeks to come up with a 
name that could be woven 
into various headings for 
each section (Historical, 
Nostalgia, Technical  etc..) 
and after much torment 
came up with MonoCall (the 
FanZine would be printed 
on paper on a monochrome 
printer) with a programming 
style Call to each section 
from a menu. It never made 
it to print as the Internet 
suddenly appeared out of 
the blue and overnight it 
seemed that all other forms 
of publishing were obsolete 
particaularly as the need to 
spend money on paper [it 
was to be free}, stamps and 
envelopes disappeared. So 
began the long tortuous 
path to learning how to 
write web pages. HTML 
was fine but it kept chan- 
ging {and continues to do 
So) each time a new brow- 
ser came out. | decided to 


even though many older brow- 
sers (including QL ones proba- 
bly) couldn't view them. You 
can't please everyone I'm afraid 
but it would include users of 
PC's, Mac's, Amiga’s and Linux. 
If | get enough complaints then 
| might put all the QL content 
on static plain pages but as | 
cannot run QL browsers on my 
lowly kit, it may be difficult to 
test it. 

Just after making the decision 
to put MonoCail on the Internet, 
another major decision was 
made (apart from getting mar- 


(EEC) WN. Richardson & Co. 


Telephone & Fax: 01494-871319 
Car phone: 07808 576118 


ried and buying a house) which 
was fo change my career at 
the tender age of 36. | had 
been in the Motor Trade man 
and boy first as a mechanic 
and then an administrator but 
redundancy forced a change of 
perspective as it so. often 
does. The Motor Trade was 
(and is) unable to sustain me 
until | retired. Something else 
had to be found. The trick is 
not to avoid redundancy (which 
iS probably impossible) but to 
be instantly re-employable 
should the worst occur. 


6 Ravensmead 
Chalfont St. Peter 
Buckinghamshire | 
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* ALSO AVAILABLE, 512k RAMPACK £40 * 
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32k RAMPACK 
128k RAMPACK 


256k EPROM PACK 
EPROM ERASER 


PARALLEL PRINTER LEAD 
SERIAL PRINTER LEAD 

* " 
TOPPER (PROTECTIVE COVER) 
CARRYING CASE (PLASTIC) 


PCLINK KIT (For PCs) 
Z88 TO MAC KIT 
Z88 TO BEC KIT 
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POSTAGE UK UP TO £5. EEC £15. USA £20. OTHER COUNTRIES £30. 
ALL THE STOCK IS WARRANTIED FOR 80 DAYS. IN THE EVENT OF REPLACEMENT 
BEING ARGREED, BUT THE ITEM BEING OUT OF STOCK AT THE TIME, A REFUND 
WILL BE MADE PROVIDED THE ITEM IS RECEIVED IN GOOD CONDITION. 
OL & PC COMPUTER USERS WILL FIND THE CAMBRIDGE Z88 ESPECIALLY USEFUL FOR WORK AWAY FROM 
THE DESKTOP, WITH TRANSFER PROGS DATA CAN BE SAFELY EXCHANGED WITH THEIR DESKTOP SYSTEM. 


W.N.RICHARDSON & CO CONTINUES TO PROVIDE FULL SPARES AND 
SERVICES FOR SINCLAIR COMPUTERS, QL & THE CAMBRIDGE Z88 


standardise on two brow- 
sers (IE 3 and Netscape 4) 
for the PC and HTML 3 
which included tables and 
frames which made the pa- 
ges look more interesting 
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| had of course been using 
computers for years and new a 
great deal but | also knew that | 
had much more to learn. If! was 
to become a Programmer (or 
anything else for that maiter) 
then | would have to be really 
sure that | could go the course 
particularly if | was to give up 
my current career | found ano- 
ther job in the Motor Trade but 
went to night school and ob- 
tained a GCSE in Computer 
Studies and a City and Guilds in 
C programming both of which 
proved very useful when | gave 
up work almost two years to 
the day after having been 


The function of 
PROCedures and the 
procedure for writing 
FuNctions 


Part 9: Why FuNctions? The result’s 


the reason! 
Mark Knight 


A PROCedure replaces a traditional BASIC sub- 
routine, and the PROCedure gets its name from 
the way it is intended to be used. PROCedures 
are defined whenever the programmer has a 
need for a particular procedure to be carried out 
in a Clearly defined way by his program, espe- 
Cially if it will be needed repeatedly. 

The FuNction gets its name from mathematics 
and from the way in which it is intended to be 
used. FuNctions in SuperBASIC and other 
BASICs are intended to be used whenever a 
calculation is required in a program, particularly if 
it is needed more than once. FuNctions in pro- 
gramming are named after mathematical func- 
tions, which are one of algebra'’s repeated pro- 
cesses. 

The word ‘calculation’ here should be seen in its 
computer programming context, not as a tradi- 
tional arithmetic process. A FuNction may carry 
out string “calculations’ and manipulations as well 
as, or instead of, numeric calculations. There are 
even reasons to write FuNctions that convert 
numbers into strings and vice-versa, in spite of 
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made redundant to start a two 
year full time course that cul 
minated in an HND in Com- 
puting qualification and a large 
credit card bill (luckily my wife 
was earning at the time and we 
could just about live off her 
Salary). Several months after 
having passed my final exams, 
i found a job as a Software 
Engineer and | have been with 
them ever since {two years). 

| count myself lucky. It could 
have all gone horribly wrong. 
What if | had failed (many who 
were considerably younger 
than me were dropping out like 
flies). What if we got into debt 


and couldn't pay the mortage (I 
did get a grant but it was pitiful). 
What if | couldn't get a job. It all 
worked out in the end. Risks 
had to be taken and they paid 
off | couldn't have done it 
without the support of my wife 
and not just financial. 

Well that just about wraps it for 
the moment. My web site now 
has some QL content (with 
more to follow) as part of 
MonoCall Issue 4. Search for 
MonoCall in AltaVista and you'll 
find it. | also welcome feedback 
and cries for help on any com- 
outer or Internet related topics. 
Hope to hear from you. 


the SuperBASIC interpreter's ability to do this for 
us a lot of the time. 

Just like PROCedures, FuNctions can be set up 
to work on parameters and these work in exactly 
the same manner as PROCedure parameters, 
being set up in the DEFine line of the FuNction. 
Just like PROCedures, FuNctions can alter values 
of parameters and the results will vary depending 
upon whether the parameters are value or 
reference parameters. 

Unlike a PROCedure though, we can PRINT the 
result of a FuNction or store it in a variable or an 
array. The result is passed back to the line that 
calls the FuNction using a RETurn line. As an 
example, a useful calculation in programming is 
elapsed time, perhaps in hours, minutes and 
seconds. A PROCedure could be written thus: 


100 CLS 

110 Elapsed_TIME 0,124124 

120 Elapsed_TIME 124,333 

130 Elapsed_TIME 0,1.234E8 

140 : 

150 DEFine PROCedure Elapsed_TIME(StartTime, 
EndTime) 

160 LOCal Hours,Minutes,Seconds 

170 LOCal Timer$(12) 


180 Timer$="" 

190 IF StartTime » EndTime THEN 

200 PRINT"Start time after end time" 
210 RETurn 

220 END IF 


230 Seconds = EndTime-StartTime 

240 IF Seconds<60 THEN 

250 PRINT"00: 00: "; Seconds 

260 RETurn 

270 END IF 

280 Minutes = INT(Seconds/60) 

290 Seconds = Seconds - (Minutes*60) 
300 Hours = INT(Minutes/60) 

310 IF Hours » 999999 THEN 
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320 PRINT"Out of range" 

330 RETurn 

340 END IF 

350 Minutes = Minutes - (Hours*60) 

360 Timer$ = Hours 

370 IF LEN(Timer$)<2 THEN Timer$ = "0"&Timer$ 
380 Timer$=Timer$&":" 

390 IF Minutes:<10 THEN 

400 Timer$=Timer$&"0"&(Minutes) 


410 ELSE 
420 Timer$=Timer$&(Minutes) 
430 END IF 


440 Timer$=Timer$&":" 
450 IF Seconds<10 THEN 
460 Timer$=Timer$&"0"&(Seconds) 


470 ELSE 
480 Timer$=Timer$&(Seconds) 
490 END IF 


500 PRINT Timer$ 
510 END DEFine Elapsed_TIME 
520 : 


This allows us to print the elapsed time any time 
(hee, hee) we wish, but it would be better if we 
could store the result and use it repeatedly, as 
well as printing it alongside other stored results. 
Storing the result alone could be acomplished by 
removing line 160 so that the Hours, Minutes and 
Seconds variables are still in existence after the 
PROCedure is called, but this doesn't solve the 
problem of storing more than one result. In addi- 
tion, remember it is usually better to use LOCal 
statements to isolate the working of a PROCe- 
dure or a FuNction from the rest of a program, so 
we really want that LOCal to remain. 

Instead of the above a much betterr solution is to 
DEFine a FuNction called something like 
“Elapsed_ TIMES’ which does the calculations for 
us, then gives us the result in a form we can 
store, PRINT or compare with others. The next 
listing shows one way of accomplishing this im- 
portant job: 


100 CIS 

110 PRINT Elapsed_TIME$(0, 124124) 

120 PRINT Elapsed_TIME$( 124,333) 

130 PRINT Elapsed_TIME$(0,"2147483647") 

140 FirstResult$=Elapsed_TIME$(0, 12345) 

150 SecondResult$=Elapsed_TIME$ (12345 ,67890) 
160 PRINT "First; ";FirstResult$, "Second; 
"; SecondResult$ 

170 : 

180 DEFine FuNction 
Elapsed_TIME$(StartTime, EndTime) 

190 LOCal Hours,Minutes,Seconds 

200 IF EndTime<StartTime THEN RETurn "Bad 
Time" 


210 Seconds = EndTime-StartTime 


220 Minutes = INT(Seconds/60) 
230 Seconds = Seconds-(Minutes*60) 
240 Hours = INT(Minutes/60) 


250 Minutes = Minutes-(Hours*60) 

260 RETurn Leading CHAR$(Hours,2,"0")&":" 
&Leading_CHAR$(Minutes,2,"0")&":" 

&Leading CHAR$(Seconds,2,"0") 
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270 END DEFine Elapsed_TIME$ 

280 : 

290 DEFine FuNction 
Leading_CHAR$(AnyNum$, Figures%, Lead$) 

300 IF LEN(AnyNum$)< Figures? THEN 

310 RETurn 

FILL$(Lead$, Figures%-LEN(AnyNum$) ) &AnyNum$ 
320 ELSE 

330 RETurn AnyNum$ 


340 END IF 
350 END DEFine Leading_CHAR$ 
360 : 


OK now we need to look at this listing carefully 
to see how it works, because clearly we have 
something very different to a PROCedure. In lines 
180 and 290 the definitions look very smilar to 
PROCedure definitions, and our Elapsed_ TIMES 
FuNction in fact takes the same parameters as 
the Elapsed_ TIME PROCedure we used earlier 
Because it gives a string result though we have 
given it a "$" sign at the end of its name, always 
a sensible idea in both SuperBASIC and SBASIC. 
Line 190 is also familiar keeping the variables 
Hours’, Minutes’ and “Seconds” isolated inside 
our FuNction, so we know they won't interfere 
with any similarly named variables our program 
might use if it grows later on. 

Line 200 though, is very different to the equiva- 
lent lines in a PROCedure, because the RE Turn is 
followed by the result string, in this case effec- 
tively an error message. All FuNctions must re- 
turn results, they can't just return without passing 
anything back to the calling routine. If the desired 
calculation can't be carried out then it is desi- 
rable to let the calling routine know in some way, 
and | have chosen to return an error message 
here instead of the usual time in a string. 

Lines 210 to 250 carry out the simple calcula- 
tions to work out the hours, minutes and se- 
conds in the result, and line 260 calls the later 
FuNction to put the result into a suitable string. 
Once it is ready the RETurn in line 260 sends it 
back to the part of the program that called the 
FuNction. 

It is the first time we have shown this, but 
PROCedures may call other PROCedures or 
FuNctions and FuNctions may call other FuNc- 
tions, and PROCedures too if desired. Instead of 
repeating the string “calculations” as the PROCe- 
dure did in lines 360 to 490 we call a separate 
FuNction three times in line 260. This has the 
added advantage that any routines we write later 
in Our program that need to pad a string to a 
minimum length with leading zeroes (or leading 
with spaces or anything else) can also call 
Leading _CHAR$. 

lf ine 130 puzzles you then it is simply explained: 
SuperBASIC is capable of using ten figure in- 
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teger numbers within the range -2,147,483,648 to 
2,147,483,647 but often LIST SAVE or PRINT will 
give only seven figures. To preserve accuracy 
the long integer is placed in a string, so the inter- 
preter will calculate the numeric value each time 
the program is run, preserving all ten digits. This 
allows our FuNction to work with up to 596,523 
hours, 14 minutes and 7 seconds, which | think is 
a pretty useful working range. 

Beware of bigger numbers if you use this 
FuNction in your own programs, as although the 
FuNction will still return a result it is likely to be 
inaccurate. 

More seriously, let's look at some FuNctions 
which could be useful in many programs; one to 
convert a string to upper case, another to lower 
case and a third to capitalise a string: 


100 CLS 

110 Test$ "Hello, this is a TEST string." 

120 Test2$ = "abcdefghijklmnopqrstuvwxyz ce ¢ é 
@ 0123456789" 

130 PRINT Test$\Test2$ 

140 PRINT UPPer$(Test$) \ LOWer$(Test$) 

150 PRINT UPPer$(Test2$) \ LOWer$(Test2$) 

160 PRINT CAPitalised$("some string or other 
originally entirely in lower case.") 

170 : 

180 DEFine FuNction UPPer$(Any$) 

190 LOCal Count, Found 

200 IF Any$="" THEN RETurn "" 

210 FOR Count=1 TO LEN(Any$) 

220 Found=CODE(Any$(Count) ) 

230 SELect ON Found 

240 =97 TO 122,128 TO 139 

250 Any$(Count)=CHR$(Found ~~ 32) 

260 END SELect 

270 END FOR Count 

280 RETurn Any$ 

290 END DEFine UPPer$ 

300 : 

310 DEFine FuNction LOWer$(Any$) 

320 LOCal Count, Found 

330 IF Any$="""THEN RETurn "" 

340 FOR Count=1 TO LEN(Any$) 

350 Found=CODE(Any$(Count) ) 

360 SELect ON Found 

370 =65 TO 90,160 TO 171 

380 Any$(Count)=CHR$(Found ~~ 32) 

390 END SELect 

400 END FOR Count 


io 


You and Your Software - 
Just good Friends? 


Part 7 - Manuals - the great unread. 
Geoff Wicks 


Deep in the archives of Just 
Words! is a lengthy letter from 
a user giving a detailed criti- 
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cism of one of my programs. It 
is a letter | valued, and | used 
some of his suggestions when 


410 RETurn Any$ 

420 END DEFine LOWer$ 

430: 

440 DEFine FuNetion CAPitalised$(Any$) 
450 IF Any$="" THEN RETurn "" 

460 Any$(1)=UPPer$(Any$(1)) 

470 RETurn Any$ 

480 END DEFine CAPitalised$ 

490 : 


Run the program to see the effect of the 
FuNctions, and look at the listing to see how they 
work. The important part here is that they return 
results using the SuperBASIC RE Turn in suitable 
lines. Just looking at UPPer$, examine line 200 
which prevents error messages by returning an 
empty string right at the start. The FOR loop 
defined in lines 210 to 270 steps through the 
string, converting any suitable characters to 
upper case. Once this is done, if anything has 
been done at all, line 280 RETurns the result. 
Another simple example uses the Turbo toolkit 
function SYS_VARS, which not surprisingly 
returns the base address of the system variables. 
Although it might be considered bad practise to 
POKE into the system, it is legitimate to use the 
various PEEK functions to read them. One use 
might be this: 


100 PRINT "System free memory=";Free_SPACE 

110 : 

120 DEFine FuNection System_SPACE 

130 RETurn PEEK_L(SYS_VARS + 16)- 
PEEK_L(SYS_VARS + 12) 

140 END DEFine System_SPACE 


This is very different to the previous examples 
because it doesn't do some work and then 
RETurn the result; it does both in a single line. 
FuNctions may RETurn the values of expressions 
as well as single values. 

So the concluson of the preceding two sections 
is that we use PROCedures when some action is 
required and FuNctions when a result is required: 
that is what these two structures are intended for 
The only way to learn is to keep using them in 
your programs and collect and examine other 
programmers efforts whenever possible. 


| upgraded the program. Never- 
theless, | could tell from the 
content that he had not read 
the program's manual. Indeed, | 
could put it even stronger 
There is evidence he had not 
even seen the manual, and was 
using a pirate version of the 
program. 

Manuals are a major headache 
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for the software author, particu- 
larly in the commercial sector 
They are costly and time con- 
suming to produce, and be- 
come rapidly out of date as a 
program is developed and im- 
proved. In spite of his efforts 
the software author knows that 
many users of his program will 
give the manual little more than 
a cursory glance. 

Many people argue that a good 
computer program does not 
need a manual. If software is 
well written, you should be able 
to use It intuitively and help will 
be provided on-screen to get 
you over the difficult bits. It is a 
powerful argument. When | test 
or review software, | initially 
keep the manual firmly shut to 
see how far | can use the pro- 
gram without looking at it. It is a 
good test of a program's user 
friendliness. 

lf we want to know what a 
world without manuals would 
be like, we need look no further 
than the PC. Walk into practical- 
ly any bookshop and you will 
see shelves full of expensive 
guides to the more popular PC 
programs. Modern PC software 
rarely comes with a compre- 
hensive manual, and has exten- 
sive on-screen help, but this 
has its limitations. Many users 
want more information than can 
be provided on-screen, and in 
effect have to pay £15 to £20 
extra to buy a manual for the 
program. 

The QL is too small to spawn a 
cottage industry of alternative 
manuals, and the software 
author has to write his own. He 
could try to write an on-screen 
manual, but would find this 
would probably more than 
double the program's memory 
needs. Whatever he does, the 
manual will be a lot of effort for 
little reward. However good or 
bad a manual is, most users will 
probably not read it. 

There are times when software 
authors are tempted to jump on 
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a table at a QL Show, and 
scream at the top of their 
voices “RIM (‘read the 
manual’) or even "RTFM". This 
iS a temptation to be avoided, 
because it is quite reasonable 
that many users do not read 
the manual. After all, why do 
you buy software? To plough 
through pages of technical in- 
formation? To read through a 
detailed history of the pro- 
gram's many versions? To be 
confronted with a lengthy dis- 
cussion about the background 
and theory? Or do you buy it to 
get the program up and running 
on your machine as quickly as 
possible? 

lf you want your users to read 
your manuals, then it is your 
job to give them something 
they will want to read. 

An impossible task? This is 
what a QL Today reviewer 
wrote about a manual: 

‘It's laid out logically and allows 
you to enter it at different 
levels and stages. So it's easy 
to find the bit you need if you 
get stuck. Or it's easy to blitz 
through the Quick Start section 
if you can't wait to get your 
hands on the program. Or it’s 
easy to quickly go to the Cus- 
tomisation section if you don't 
like the results with the current 
configuration. 

Essentially it’s difficult to fault. It 
told me everything | needed to 
know, gave me no difficulties in 
finding the relevant section, ex- 
plained the menu structure con- 
cisely, gave numerous exam- 
ples in the glossary and co- 
vered everything.” 

At this stage | have to confess 
this a bit of free advertising, be- 
cause the reviewer was descri- 
bing a Just Words! manual. So 
what are my concepts when | 
write a manual? 

Firstly design is important. A 
manual must look attractive, 
and be laid out in such a way 
that the reader can quickly find 
what he is looking for Just 


Words! manuals are written, 
spell-checked and _ style- 
checked on the QL, but are 
then transferred to a PC word 
processor for the final design. 
Sorry about that, but QL word 
processors, with the possible 
exception of Text 87, have fe- 
wer design possibilities than 
PC programs. 

The present generation of Just 
Words! manuals are A4 folders, 
with two columns of text, which 
is easier to read than one co- 
lumn. There is a bold header at 
the top of each page descri- 
bing its contents. Within the 
text, important items such as 
menu commands are highligh- 
ted by being printed in bold 
Capital letters in a slightly larger 
font than the main body of the 
text. When a user thumbs 
through the manual, these 
items stand out, which makes it 
easier for him to find what he is 
looking for If he cannot find it, 
there is an index at the back to 
help him, and there are also 
illustrations of the main menus. 
lf you are writing for the free- 
ware market, your manual will 
be either a Quill or ASCII file, 
and you will have fewer design 
possibilities, but it is worthwhile 
to look at the layout of your 
document to ensure it is as 
user-friendly as possible. 
Secondly a Just Words! manual 
has three main sections, de- 
signed for different stages of 
experience in using the pro- 
gram. 

The first section is Basic Infor- 
mation. It is what you need be- 
fore you buy the program and 
during installation. It gives infor- 
mation people need when they 
are browsing through the ma- 
nual at a show. It tells them 
what the program does, what 
the system requirements are, 
what files are on the disk and 
how to install the program on a 
hard disk. 

The second section is the 
Quick Start. This has proved to 
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be the most popular feature of 
my manuals. It is a simple step 
by step tutorial to illustrate the 
main features of the program, 
and can usually be followed 
without further reference to the 
manual. 

The third section is the remain- 
der of the manual. Some users 


will read this, and some will not. 
if a user wants to read the 
manual from cover to cover, it 
will tell him about the program 
in some depth. Alternatively if 
he does not want to read it, he 
can use it as a reference work 
for when he gets stuck. Hence 
the importance of a design that 


makes things easy to find. 
Manuals are the great unread, 
but some are more unread than 
others. A user-friendly manual 
is an essential part of user- 
friendly software. 
Next time: What 
doesn't see. 


the user 


CAUTION: HOTKEYS - Don’t 
Burn Your Fingers, Part 3 


David Denham 


So far in this series we've covered most of the 
BASIC commands and functions used in the 
Hotkey system. In this part we'll look at two 
general extensions not fully covered so far 
(HOT_KEY and HOT_WAKE) then take a look at 
the Stuffer Buffer and its associated controls in 
the next issue. 


HOT_KEY 

lf you have used Toolkit 2's ALTKEY command to 
define keys to hold shortcut strings for you, you'll 
find HOT_KEY a little familiar HOT_KEY is a 
function rather than a command like ALTKEY In 
QDOS terms it works rather differently - the 
QPAC2 manual explains that ALTKEY works via a 
polling task while HOT_KEY is via a hotkey job. 
As far as you the user are concerned you can 
achieve pretty much the same results with both. 
In essence, HOT_KEY assigns text to a key. 
That's it. 

In case you wonder what makes this any different 
to HOT_CMD, bear in mind that HOT_CMD is 
used to send commands to BASIC, rather than 
text as such. HOT_KEY sends the text into the 
current keyboard queue instead. 


A simple example 

Suppose the period *’ key is broken and while we 
wait for a new keyboard membrane from Tony 
Firshman we decide we could work around this 
problem by defining an alternative keypress 
which allows us to press ALT and another key to 
give us a period character instead. In this case, 
well make ALT comma key give us a period or 
full stop character 

ERT HOT KEY ON) 

The confusing looking strip of quotes and 
commas hides a simple fact, that when ALT and 
comma keys are pressed, the QL gives us the full 
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stop symbol we needed to work around our 
problem. 

Another example. Suppose the QL is used in a 
business which exports goods to various coun- 
tries. You frequently need to access the currency 
symbols not marked on your keyboard but 
available via CTRL/SHIFT keys, as listed in the 
Character Set section of the Concepts User 
Guide. We can define hotkeys to give us these 
currency symbols from easily memorable keys 
(ALT p for Pound Sterling, ALT y for Yen, ALT d for 
Dollar ALT e for Euro if you have SMSQ/E and 
ALT c for Cent) 

We can examine the character set with this short 
program which tells us which CODE value repre- 
sents each character: 

FOR a = 32 TO 191 

PRINT ! a&'='&CHR$(a) ! 

END FOR a 

On a UK. character set machine we'd get the 
following codes: 

Pound = 96 

Dollar = 36 

Cent = 157 

Yen = 158 

Euro = 181 (recent versions of SMSQE only) 

So we can define easily memorisable currency 
symbol keys: 

ERT HOT_KEY('p',CHR$(96) ) 

ERT HOT_KEY('d' ,CHR$(36) ) 

ERT HOT_KEY('c',CHR$(157) ) 

ERT HOT_KEY('y',CHR$(158) ) 

ERT HOT_KEY('e', CHR$(181)) 

You can use CHR$ to add non-printable codes 
too, such as the codes for the function keys, e.g. 
this example defines ALT f as the F3 key, not very 
useful in itself but becomes more useful when you 
combine this with the letters that control the com- 
mands menus in Quill, Archive, etc. 240 is the cha- 
racter code for the F3 key (these are listed in the 
Character Set section of the Concepts part of the 
QL User Guide) 

ERT HOT_KEY('f' ,CHR$(240) ) 

We can create a little macro from this to create a 
shortcut to the PRINT command in Quill. Normally, 
the sequence of key presses would be: 
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press F3 for the command menu press p for Print 
press ENTER when it asks “Current” press ENTER 
again when it asks “Whole” press ENTER again 
when it asks “to printer’ 

So we need an F3 keypress code, ap” and three 
ENTER characters. 

It is worth noting that HOT_KEY has a special 
feature when dealing with ENTER characters and 
multiple strings. If you include several strings in a 
definition separated by commas, they are sent 
with an enter character between them. If you add 
an empty string after a comma (a ") in effect this 
creates a blank line - useful right at the end of a 
definition for example. 

So to define ALT f as our Print whole document 
shortcut in Quill we use: 

ERT HOT_KEY ( "eM" chr$ (240) &"p", wi, mu ' ny 
Bear in mind that the apostrophe and quote 
symbols are interchangeable in the hotkey 
system - you could use ” or ” 

This feature allows us to define keys which hold 
several lines of text. We can use this to enter 
commonly used addresses for example: 

ERT HOT_KEY('j','Jochen Merz','Im Stillen 
Winkel 12','D-47169 Duisburg 11') 

This inserts the address as 3 lines of text. Inser- 
ted into Quill, these appear at the left margin, 
which is no good for a letter They would need to 
be manually TABbed over to the right. No pro- 
blem, get the hotkey to do it using CHR$(9) as 
TAB key presses: 

ERT HOT_KEY('j',CHR$(9) &CHR$(9) &CHR$(9) 
&' Jochen Merz', CHR$(9) &CHR$(9) &CHR$(9) 
&'Im Stillen Winkel 12', CHR$(9) &CHR$(9) 
&CHR$(9) &'D-47169 Duisburg 11') 
Although it would involve some long and clumsy 
key definitions, you could store your letterheads 
as little text macros in this way - it wouldn't take 
too much effort to write a short BASIC program 
which let you type in a few lines of text (a few 
INPUT statements}, asked you which key to 
assign these definitions to, and then build a 
HOT_KEY statement by printing it to a file with a 
line number in front of it which you could merge 
with your boot program! 


HOT_WAKE 

A HOT_WAKE is rather like a HOT_PICK in the 
sense that it will pick the job specified, but in ad- 
dition it sends a WAKE event to the job which in 
the case of some programs such as QPAC2 
menus which respond to WAKE events causes a 
particular action to take place, such as refresh a 
menu. The Files menu of QPAC2 will read the disk 
again to update or refresh its list of files upon 
being given a WAKE signal. 
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in addition to this action, if the specified job is not 
running, but an executable thing of that name 
exists it will be started. 

lf you don't know much about Things (and | cer- 
tainly don't) just think of executable things as little 
programs which have been stored in memory but 
are not actually running - they are like BASIC 
extensions you load with RESPR or LRESPR, they 
only actually run when you type in their name. 
These executable Things can be started with an 
EXEP command usually rather than an EXEC 
command. Examples of executable Things are 
QPAC2 menus (Files menu, Jobs menu, Exec 
menu etc} and most normal Job style programs 
(those you can EXEC from disk) which have been 
installed in memory with HOT_RES and HOT_CHP 
commands. In effect, you have used HOT_RES or 
HOT_CHP to plant them ready in memory, then 
you use HOT_WAKE commands to start them 
and pick them. In addition, there is also the 
HOT_THING function which allows you to start 
such Things, just to complicate matters, so I'l 
leave it at that as | am getting into deep water 
over Things. 

One particular feature is that HOT_WAKE tries to 
pick a job name, if that doesn't exist it tries to 
start a job instead. In effect this means that it only 
ever starts one copy of a named job. This is 
useful for QPAC2 Files menus - if you already 
have one open it can be useful that the 
HOT_WAKE first tries to use the existing one 
before cluttering up your screen starting multiple 
copies! 

ERT HOT_WAKE('f','Files') 

This will do one of two things - if a QPAC2 Files 
menu is already open it will pick that menu and 
send a wake event to update the list of files as 
though you had pressed CTRL F2 or hit the little 
lightning icon top right of the menu. But if no Files 
menu was running when you pressed ALT f a new 
copy is run in the normal way. 


HOT_THING 

ERT HOT_THING('f', 'files') 

will start an executable Thing called Files, in this 
case the QPAC2 files menu, and _ unlike 
HOT_WAKE always starts a new copy - useful if 
you want to use two files menus to compare lists 
of files on separate drives. Perhaps more usefully, 
you can set up a HOT_THING hotkey to start the 
EXEC menu of QPAC2 from which you can 
access most of the Things in QPAC2: 

ERT HOT_THING('x', 'Exec') 

QPAC2 has a useful Thing called 
BUTTON_SLEEP which minimises programs 
down to a button in the button frame. It is possible 
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to access this from the EXEC menu, but why 
bother when you can simply assign it to a 


HOT_THING hotkey: 


ERT HOT_THING('s', 'Button_Sleep') 
SO when you press ALT s the current program 


gets made into a sleeping button in the button 
frame, clearing precious screen space and redu- 


cing clutter This assumes of course it's a pro- 


gram which can be made into a button (most 
normal programs can). 


A dozen Progs You shouldn't live 


without 


Darren Branagh 


In a recent issue of QUANTA, 
(Feb. 2000) John Gregory, took 
a look at some of the programs 
he found useful in the QUANTA 
library over the years, and has 
installed on his system. | found it 
a very informative article, and 
thought QL Today could benefit 
from the same kind of thing. | 
was aware of all of the pro- 
grams John mentioned, (even 
having written one of them my- 
Self!) but had forgotten about a 
few of them until reminded by 
the article. 

The QUANTA library really is a 
treasure trove of programs, ma- 
ny of which cannot be found 
elsewhere, and in my opinion 
membership of QUANTA is |usti- 
fied on this alone. However, 
there are also quite a lot of other 
PD and freeware programs be- 
ing supplied by the PD libraries, 
most notably Phil Jordan. 

In the following paragraphs, I've 
taken a look at some of the 
programs | use both regularly, 
and now and again when nee- 
ded. Together they make up a 
valuable arsenal of program- 
ming power, and the best part is, 
they didn't cost me a penny! 
These programs are so simple 
to run and use that they don't 
warrant a review of their own, 
as they are simply a case of 
loading them and they do their 
thing then go away. | know | 
couldn't do without some of 
them most of the time, and 
maybe you are unaware of 
them, and may find them useful 
too. 
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1. THE STRIPPER 


For all of those readers who 
think a stripper is something 
else entirely, shame on you. It's 
actually a simple to use pro- 
gram to remove unwanted con- 
trol codes from files, in order to 
turn them into plain ASCII text. 
it works perfectly on QUILL 
doc files for example. All you 
do is load it, and type the name 
of the file to strip, and it does it. 
easy and very useful. 


2. SCROBMP 

Written by Norman Dunbar. This 
program will convert standard 
QL screens (32K) into bitmap 
images, which are common on 
PC's (The microsoft windows 
wallpaper is stored in bitmap 
format, for example) very useful 
again, and as easy to use as 
THE STRIPPER - just EXEC it, 
and give a _SCR filename and 
location, and it will output it as a 
Bitmap screen, which can be 
saved where you like. 


3. SCROPCX 

As above, but will convert to 
the equally popular PCX gra- 
phics format instead. There are 
tonnes of PCX Clipart in the PC 
world, and this allows you to 
add some more. This one can 
handle mode 4 or 8 screens, 
with parameters being passed 
at startup, and even supports 
wildcards too. eg. 

EXEC SCR2PCX; 'flpi_*_SCR 8 
rami_' 

will convert all the screen files 
on fipi_ in mode 8 to PCX files 
on ramt_. 


4. THE COPIER 


Have you ever had problems 
copying a disk with level 2 sub- 
directories on it? | remember | 
did, when | first moved from a 
Trump Card to a QXL in one go, 
as this was the first piece of 
hardware | had which suppor- 
ted it. That was, before Dilwyn 
Jones wrote The Copier This 
excellent program will make an 
exact copy of any disk, inclu- 
ding ALL subdirectories, and 
will copy all files to the correct 
location. You can even specify 
which files or directories are 
copied. The locations can be 
any device, so it is even a rudi- 
mentary and basic way of 
doing backups of your hard 
drive. All you do is enter the 
drive or directory to copy from, 
and the destination - simple. 
Another Program called Sub- 
COPY does the same thing, 
and there is also a utility on the 
ProWesS disk which will also 
do this (ProWesS is now no 
longer commercial software). 


5. QFORMAT 

Again by Norman Dunbar this is 
a quick disk formatter It will 
completely erase any DD, HD 
or even ED disk, with a new 
volume name of your choice, in 
only a few seconds. Much 
quicker than formatting from 
the command line under Super- 
basic, which takes several mr 
nutes. 


6. SORTBACK 

Another program by Dilwyn, 
which is a simple way of 
alphabetically sorting all the 
files in your disks. It will sort the 
files in any order and allows 
you to copy them back onto 
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the disk in the way they where 
sorted. Makes it very easy to 
find certain files on your disks if 
all the files appear alphabeti- 
cally when DiR'ed, | can tell 
youl! 


7. QRISTEN 

Pronounced ‘“Chris-en’ (You'll 
see why in a minute) this is a 
pointer program that allows 
you to quickly rename a disk 
without the need to format it 
first. Useful if you have copied 
the contents of something onto 
a disk that has a meaningless 
volume name on it. | wrote a 
Superbasic program some time 
ago to do this, but this is much 
easier to use and can be 
placed on a Button easily too. 
There is another similar pro- 
gram called simply labeler 
which does the same job - 
Both are PD. 


8. FREEMEM 

This displays the amount of 
free memory on your system, 
on a button in your button 
frame. Simple and useful, and 
updates constantly. Available 
for download from Jonathan 
Hudson's website. 


9, DOCVIEWER 

A pointer driven Quill doc 
viewer quite simply put. Fire 
this up and you can have a 


QLTdis - part four 


Norman Dunbar 


Following on from PRINT_HEX, we have some 
useful routines to copy strings, append one string 
to another, and to add a byte, word or long word 


of text to an existing string. 


First up, is STR.COPY which simply takes the 
string at Ail and copies it to A2 overwriting 
whatever was at A2 originally. Very similar to LET 


A2$ = A1S$ in SuperBasic. Here it is: btst #004 
bne.s strnext 
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quick read of any quill file easily, 
with the added bonus of being 
able to scroll through it all using 
just the mouse, which you can't 
do under Quill, or Xchange. All 
the original formatting of the 
quill file is displayed correctly, 
although its worth pointing out 
that changes cannot be made 
to files as its simply a viewer 
program. 


10. HTML MACHINE 

A clever program written by 
Roy Wood to allow HIML 
(hyper Text Markup Language) 
which is common on the Inter- 
net to be typed on a QL. The 
HTML Machine will pop-up over 
a text editor (it's designed for 
use on QD, but should work 
with any} and allow you to 
select from a range of HTML 
tags to be placed into the text. 
As HTML grows in popularity, 
this is an excellent program to 
aid using basic HTML on a QL. 


11. GRAPHICS VIEWER 


Another one by Dilwyn (does 
this man ever take time to 
breathe?) and the title says it all. 
It's a great little program, which 
can be used to view files in a 
wide variety of formats - _PIC 
and _SCR are supported, QL 
DTP programs pages and even 
a couple of PC formats. Fully 
pointer driven, with resizable 


windowing and the pointer file- 
Select menu to choose your 
clipart or graphic to view. As 
easy to use as all Dilwyn’s pro- 
grams. 


12. PROCMAN 


Ever written a really great set 
of superbasic procedures for a 
certain project, only to find the 
Same procedures useful in ano- 
ther project some time later?? 
Rather than SAVE and MERGE 
files to get at them, PROCMAN 
will easily seek out all the pro- 
cedures in any superbasic pro- 
gram, and allow you to extract 
them individually or all together 
as you wish, and save them for 
later use. A gift for the budding 
and experienced programmer 
alike. 


There you go. All of these are 
in the QUANTA library, and also 
most are available from Phil 
Jordans Library service too. If 
you are not a QUANTA mem- 
ber there are many programs in 
there that you will not be able 
to get, and its this reason 
alone that justifies the member- 
ship price in my mind. The 
QUANTA library is full of goo- 
dies, so order a copy of the 
LIBGUIDE on disk today, you'll 
be glad you did. If you're not a 
member, then Join - as you'll 
find it is the best few quid 
you've ever spent. 


* Copies a string from A1.L to A2.L overwriting the 
* current contents of the buffer at A2.L. 


* No errors returned. If the length of the string to 
* be copied is even, move words - it is quicker. 
x 


% Expects Ai.L to hold the 'from' string address. 


% Expects A2.L to hold the 'to' string address. 
Corrupts DA, Al and A2. 


str_copy 


¥ 
¥ ssc2csssss=s=scs== 


move.w (ai)+,d4 
move.w 44,(a2)+ 


; Get size of 'from' string 

; Set new size of 'to' string 

3; Is D4 even ? (size of string) 

; Do byte moves - odd sized string 
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str_even 
Isr.w 
bra.s 


#1,04 
str_enext 


; Divide length by 2 
; Do word moves - even sized string 


str_emove 
move.W 

str_enext 
dbra d4,str_emove ; And the rest 
rts 


(at)+,(a2)+ ; Move a single word 


str_move 

move.b (ai)+,(a2)+ ; Move a single byte 
str_next 

dbra d4,str_move ; And the rest 

rts 3 Exit 


As you now know, a QDOS string is held in 
memory starting at an even address, with a single 
word of data holding the length of the string (not 
including the word itself). Immediately after this 
word is the individual bytes of the string. 

To copy one string to another is quite simple - get 
the size of the ‘from’ string and move it to the ‘to’ 
string’s length. Then copy each byte across. 


in this routine we first get the length of the string 
we are copying into D4.W - we shall be using this 
as a counter of bytes to copy. This is then stored 
at the destination address held in A2 and A2 is set 
to pint to the position where the first character will 
be stored when we start copying. 


lf bit zero of the length of the string is clear then 
we have an even number of bytes to transfer This 
means that we can use word sized copies instead 
of byte sized and thus do fewer of them which 
speeds up the program a bit. Obviously if moving 
words around, we only need half as many, so D4 
is divided by 2 to keep the count correct. 


lf the length is odd we simply copy each byte 
over one by one. This keeps the routine fairly 
simple as we could have easily moved the first 'n’ 
words and when only one byte left moved it on its 
own. 


As an exercise, iry rewriting str_copy to do the 
following: 


1. Calculate how many words to move and how 
many spare bytes (either 1 or 0) 

2. Move the required number of words first - 
guess why? 

3, Move the final byte. 


In case you were wondering, if you move the 
spare byte first, this makes the to and from 
addresses ODD so the first word you move will 
cause an address exception error - oops! 
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The next routine allows us to append to a string. 
Appending to a string is a bit more difficult. LET 
A2$ = A2$ + Al$ is the equivalent Superbasic 
code. Lets see how this is done. 


* Appends a string from A1.L to A2.L adding it to the end 
¥ of the current contents of the buffer at A2.L. 

® No errors returned. 

% 

* Expects Al.L to hold the ‘from' string address. 

% Expects A2.L to hold the 'to' string address. 

* Corrupts D4, D3, Al and A2, 


str_append 
move.w {at)+,d4 ; Size of 'from' string 
move.w (a2),d3 ; Size of 'to' string 
add.w  d4,(a2)+ ; New size of 'to' string 
adda.w d3,a2 ; New 'to' string end position 
ptst #044 ; Is the from string even sized? 
beq.s str_even ; Move string in words 
bra.s  strnext ; Copy all bytes over 


lf this seems very short - it is! 


All we do here is collect the ‘from’ string length 
and the ‘to’ string length. Having done this, the 
size of the ‘to’ string has to be the combined size 
of both strings, so we add the sizes together and 
store in the size word for the ‘to’ string. Now we 
have the to string set to the correct length, we 
copy the bytes of the ‘from’ string over to the 
end of the ‘to’ string. To calculate this position, we 
add the old size word of the ‘to’ string to the 
address of its first character. 


Assume the two strings are as follows and that 
the ADDR values are simply the address relative 
to the start of the two strings as opposed to an 
actual address in memory otherwise both strings 
would be stored in the same place! 


Addr : 00 01 02 03 04 05 06 07 08 09 10 
From : 0004 F R O M 
To : 00 02 T O 


We add the sizes together to get this: 


Addr : 00 01 02 03 04 05 06 07 08 09 10 
From ; 00 04 F R O M 
To : 00 0O6T O 


A2 is adjusted to point at the first character (the 
'T) in the ‘to’ string by the ADDW D4{A2)}+’. Note 
that you cannot ADDAW D3{A2)+ which is why 
there are two different instructions in this routine 
to add to the address registers. 


So if we now have A2 holding address $02 in the 
‘to’ string and add the length of the old ‘to’ string - 
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im stillen Winkel 12 D-47169 Duisburg 
Tel. 0203 502011 Fax 0203 502012 
http://www. j-m-s.com/smsq/ index.htm 


OPC II 


|We're not giving a full list of what QPC is: to make it short: it allows you to run the 
majority of QL Programs on PCs, and comes with the QDOS-compatible (but much 
| faster and better) operating system SMSQ/E. 


|So what’s OPC II then? 


The more advanced version of QPC. Whereas QPC required your PC to run in DOS mode only while 
QPC was running, QPC II now allows you to multitask with Windows95, 98 and NT. You do not need 
to run your system down and up to start QPC li, just double-click it and it starts. Also, the 
configuration of QPC Ii is MUCH easier - it is done in a configuration window where all settings can 
be easily done. Installation is much easier too, all is done automatically with an installation program, 
or you just execute it directly from floppy disk or harddisk. 
We have also reacted on the requests of many users: you can now have the QL windows scaled! 
For example, if you have a graphics card or a laptop with a resolution of 1024x768 pixels, then you 
can decide whether you want to use the full resolution (thus giving you 1024x768 pixels for the QL 
.. high resolution with small fonts) or if you want the 512x256 pixels to be scaled into 1024x768 (so 
that you have a large, nice original QL display). We 
discovered that using other devices is much easier © 
too: if you have a laptop and a PCMCIA-modem (which 
| acts as COM4, for example) then you can access it 
from QPC Il as well. 


So, with QPC Il you get 

« the advantages of QPC 

«@ plus much easier installation 

« plus much easier configuration 

«@ plus multitasking with Windows 

«@ plus scaleable screen resolution EY 


AT THE SAME PRICE AS BEFORE - only DM 249,- 


| You can upgrade to QPC Il if you already own QPC by sending in your QPC master disk 
(don't worry, you get it back Il with the latest version of QPC). The price iS only DM 79.90. 


To run QPC li, you need at least a 486 or Pentium, 16MB of RAM, VGA, Windows 95,98 or NT and DirectX. 


TERR FF PAYMENT 
Postage and package [Germany] DM 8,99 (if total value of goods is up to DM 50,- then only DM 5,99). [Europe] DM 14,50 (if 
total value oF ee is up to DM 50,- then only DM 9,50). [@verseas] between DM 14,50 (1 item) and DM 35,- dremrgin All 
: prices incl. 15% V.AT. (can be deducted for orders from 
non-EEC-countries}. E&OE. Cheques in DM, £’s,| : 
WW wi Eurocheques and Credit Cards accepted. i 
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lim stillen Winkel 12 D-47169 Duisburg 
Tel. 0203 502011 Fax 0203 502012 
http:/www.j-m-—s.com/smsq/index.htm 


hen Merz ftwore A lications and Version Num 


1QPC1 «+ QPC2 + SMSQZE Software QL-EmulatorforPC’s ... [V1.54] .. . DM 249, 
54)... . DM 199,- 
PC1 + Q@PC2 + SMSQ/E Upgrade from QPC1 54]... DM 79,90 
SMSQ/E for ATARI or QXL or (Super)GoldCard 97]... . DM 249,- 
QD 98 Pointer-Environment-Editor 06]... . DM 119,- 
QD 98 Upgrade from V9 06]... . DM 39,90 
QD 98 Upgrade from previous versions 06]... . DM 49,90 
NEW! AGENDA for WMAN or ProWesS 08]... . DM 59,90 
NEW! SUQCESS Database program for the Pointer Environment DM 79,90 
| QMAKE Pointer-driven MAKE for GST/Quanta Assembler 26]... . DM 45,- 
BASIC Linker 16]... . DM 49,- 
WINED Floppy/Harddisk Sector- & File-Editor A ... DM 49,- 
| Fai (i Filefinder - Extremely useful! g .... DM 49, 
FiFi I! Upgrade from earlier versions 22|.... DM 719,- 
EPROM Manager 02}... . DM 49,- 
QSpread99 Spreadsheet Program 08]... . DM 139,- 
QSpread99 Upgrade 08]... . DM 39,90 
QPAC | Utility programs 07|.... DM 59,- 
QPAC II Files, Jobs & other Things 39]... . DM 119,- 
QPAC II Update 39]... DM 16,- 
QTYP II Spell checker : .... DM 739, 
QMENU The Menu Extension Programming Manual 04]... . DM 41,90 
QMENU Upgrade 04)... . DM 18,- 
QPTR Pointer Toolkit : ... DM 89,- 
QPTR Update 30]... . DM 16,- 
DISA Interactive Disassembler 04)... . DM 89,- 
DISA Upgrade from previous versions 04]... DM 33,- 
typeset-ESC/P2 text87 driver for all ESC/P2 printers (incl. Stylus) DM 65,- 
... DM 90, 
CueShell for QPC : . DM 40, 
Even if you already own QPC, you can upgrade to include CueShell for DM 40,-111 
SER Mouse software mouse driver for serial mice DM 25,- 
| EASYPTR Part 1&2 10]... . DM 89,- 
| QDOS/SMSQ Reference Manual 


TERMS OF PAYMENT 
Postage and package oe DM 8,99 (if total value of goods is up to DM 50, then only DM 5,99). [Europe] DM 14,50 (if 
total value of g o DM 50,- then only DM 9,50). [Gverseas] between DM 14,50 (1 item) and DM 35,~ (maximum). All 
C ls = “ uke incl. 15% V.A.T. (can be deducted for orders from (~~ 


= [ A i non-EEC-countries). E&OE. Cheques in DM,  £’s, 
Ce . WHEGKKIGKGy Eurocheques and Credit Cards accepted. i 
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which was $02 to it, we get A2 pointing at ad- 
dress $04. Looking ath the above, $04 is the 
place where we want to put the first character 
from the ‘from’ string. Easy when you see it! (l use 
a lot of squared paper when | am working with 
addresses}} 


So, once we know this address, we skip back- 
wards into STR-COPY to copy the bytes over 
either as words or as bytes. Code re-use - what a 
wonderful thing! 


At various places in the final program, there will 
be a need to add one, two, three or four charac- 
ters to an existing string. This is simply adding 
characters and not proper strings so the above 
routine, STR-APPEND, cannot be used as it is, 
because we don't have a word at the start of the 
characters we wish to add. 


It would be quite simple to do something like the 
following {assume that A5 holds the address of 
the first spare character space after the END of 
the string to be appended to} 


NOVE.B #'L', DA 
MOVE.B D4, (A5)+ 


And this will actually work without problems all 
the time. However, the following will not work all 
the time - why? 


MOVE.W #'A7!,D4 
MOVE.W D4, (A5)+ 


or 


MOVE.L #"ADDA' DA 
MOVE.L D4, (A5)+ 


Have you figured out what is wrong ? It is quite 
simple, and quite difficult to figure out when tes- 
ting a program that seems to randomly cause 
problems. lf we start off with A5 holding an EVEN 
address, the above code will work. We are al- 
lowed to perform word and long sized operations 
at even addresses. But, if we have already added 
one byte to the string at A5, A5 now holds an 
ODD address. The above code will now cause an 
address error Nasty, so beware. 


The following routines allow the addition of four, 
two or one bytes to the end of the Ad buffer 
These will be used when building up the decoded 
instructions in the main program. 


¥ ssencersscsstsssssssse asset rrsstsrr sss eesssesssssstz=ss 
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% Adds the 4 bytes in DA.L to the buffer at A5.L. This is 
* our decoded instruction «so far» and we are adding 

* another 4 bytes to it. See text for why we do it this 
* way and not as MOVE.L D4,(A5)+ 1! 

¥ 


* Expects D4. to hold the 4 bytes we wish to append to 

* the buffer. 

* Expects D6.W to hold the size decoded so far. 

% Expects A5.L to point to the first free space in the buffer. 
® Preserves D4, A5 and D6 are updated. 


¥ ee ee ce ae ae res Sav Sy eae a ae ge ae we eee a aa ene ae ae weer enna aaae ee eee ee 
str_add_l 
bsr.s a5_even ; Test if Ad is even 
bne.s striadd.4 ; A5 is odd 
move.) d4,(a5)+ ; A5 is even - yippee ! 
addq.w #4,d6 ; Update counter 
rts ; Done 
str_add_4 
swap 4 ; Change 'ABCD' to 'CDAB' 
bsr.s striadd_2  ; Append 'AB' part first 
swap 4 ; Change ‘CDAB' back to 'ABCD! 
bsr.s stradd_2  ; Append 'CD! part. 
rts 
¥ SSS eS ee eee eee ee ee eS SS SSeS ees eases Ses Sse 
® str_addw 
¥ Se ae ae eae tc ne pp foe ap tae oem apn igtonae ante ae oe eee eae ew se od nes Oe Se en ee eae een Se 


% Adds the 2 bytes in D4.W to the buffer at A5.L. This is 

* our decoded instruction «so far) and we are adding another 
¥ 2 bytes to it. See text for why we do it this way and not 

% as MOVE.W D4,(A5)+ !! 

% 

% Expects D4.W to hold the 2 bytes we wish to append to the 

* buffer. 

* Expects D6.W to hold the size decoded so far, 

* Expects A5.L to point to the first free space in the buffer. 
* Preserves D4, A5 and D6 are updated. 


¥ SSSSRS SSS SS PRS SS AAS SS SSS LEV SS SSS TSS SSSR SSSA L SS SSS Sss2sS 
str_add_w 
bsr.s a5_even 3 Is Ad even ? 
bne.s stradd.2 ; Apparently not 
move.w d4,(a5)+  ; It is - store D4.W in the buffer 
addq.w #2,d5 ; Update counter 
rts ; Done 
str_add_2 
rol.w #8,d4 ; Change 'EF* to 'FE! 
bsr.s stradd.b }; Append the 'Z' part first 
rol.w #8,d4 ; Change 'FE' back to ‘EF! 
bsr.s stradd_b ; Append the 'F' next 
rts ; Done 


¥ Adds the byte in D4.B to the buffer at A5.L. This is our 

* decoded instruction «so far» and we are adding another 

* byte to it. 

x 

¥ Expects D4.B to hold the byte we wish to append to the 

¥ buffer. 

* Expects D6.W to hold the size decoded so far. 

* Expects A5.L to point to the first free space in the buffer. 
% Preserves D4, A5 and D6 are updated. 


str_add_b 
move.b d4,(a5)+ ; Store a single byte 
addq.w #1,d6 ; D6 holds size of text so far 
rts ; Go back from whence we came. 
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* Tests bit zero of A5 to see if it is even. If it is we can 
% store words and long words at the location held in A5. 

% Otherwise we can't. 

% 

® Expects A5 to hold an address. 

® Preserves everything. 

* Returns Z set if A5 is even, clear if A5 is odd. 


ad_even 
exg d0,a5 ; A5 is required in a data 
register 
btst  #0,d0 ; Sets Z if DO is (now) even 
exg d0,a5 ; Doesn't affect the flags 
rts ; Done 
¥ SPPSI PI IMSS SST Po S IT SSS SVS IL SILLS SSS SS SSS TL SSS SS SSL SS TSS 
* str_add_3 : 


* Adds the 3 bytes in D4.L to the buffer at A5.L. 

* This is our decoded instruction «so far» and we are 

* adding another 3 bytes to it. 

# 

* Expects D4.L to hold the 3 bytes we wish to append to the 

* buffer. 

* Expects Dé6.W to hold the size decoded so far. 

* Expects A5.L to point to the first free space in the buffer. 
* Preserves D4, A5 and D6 are updated. 


str_add_3 
swap 4 ; Change '?ABC' to 'BC?A' (? = don't care) 


bsr.s str_add_b 5 Append 'A' part first 

swap 4 ; Change 'BC?A' back to '?ABC! 
bsr.s stradd.w  ; Store the 'BC' part 

rts "3 ALL done. 


The easiest one to figure out is STR-ADD_B as it 
simply adds one byte to the string length. We wil 
be using D6 to hold the completed size of the 
decoded instruction, so we increment its total as 
well. 


The routine ab_even is called when we want to 
add 2 or 4 bytes to the A5 buffer This simply 
returns the Z flag set if AD is an even address. As 
you cannot test the individual bits in an address 
register, we swap A5 and DO over, test DO - which 
sets the Z flag accordingly, swap A5 and DO back 
again - which does not change any of the flags, 
so Z is still correct and then we return. 


Next up, is STR_ADD_W which adds two bytes, 
one at a time to the A5 buffer by calling 
STR_ADD_B twice. Notice how similar this is to 
the HEX routines earlier The process is very 
similar We must swap the order of the bytes in 
D4W before we add them to the buffer If we 
detected that A5 is even, then we don't have to 
bother with swapping etc and we simply store the 
word in D4 at the address in Ad - so much simpler 
when things are even. 
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And again, the same with STR_ADD_L where we 
must swap low and high words over before we 
can add text to the buffer Again, if A5 proves to 
be even, we simply store the long word in D4 at 
the address in A5. 


After STR_ADD_B there is STR-ADD_3 which is 
used to add three bytes from D4 to the buffer 
This is very similar to the STR-ADD_L routine, 
but only stores the lowest 3 bytes of D4 in the 
buffer It does this by first swapping the two 
words of D4, storing one byte froom the (now) 
low word, swapping the words back again and 
storing the entire low word. Simple stuff. 


Finally for UTILS_ASM, we have the routine 
ADD_SPACES which adds any number of spaces 
to the A5 buffer This will be used to pad out the 
decoded instructions as we go along. On entry, 
D4W holds the number of spaces to add. 


* Adds D4.W spaces to the output buffer. 

% 

* Expects D4.W to hold the number of spaces we wish to append. 
* Expects D6.W to hold the size decoded so far. 

* Expects A5.L to point to the first free space in the buffer. 
* Corrupts D4 (always -1), A5 and D6 updated. 

% SSPSS SSS SS SeRSSSSrVPSsSSSsTrTSSSsssTsrSsrtsssssses2s=ss2e=2 


add_spaces 

add.w 4,46 ; New size of text 

bra.s add_next ; Skip the first move 
add_space 

move.b #' ',(a5)+  ; Add a single space 
add_next 

dbra  d4,add_space ; And the rest 

rts ; Exit with DO = -1 


The routine is very simple, it adds the number of 
spaces to D6 as we are keeping a running total 
of the instruction, and then enters a DBRA loop to 
add a space to the buffer as many times as it has 
to. A nice simple bit of code to finish this file on. 


DISS_ASM 


We now have to build the decoding table. Using 
the information in previous articles, and the data 
from the last one, we add the following to the end 
of the DISS_ASM file. 


This is probably the biggest (and most boring) 
change we will have to do - this issue, we define 
two of the big tables of data in the program. First 
up is the ‘MASKS’ table which is used when we 
have an op-code to decode. We mask the op- 
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code with the first word in each entry and check de.w  $£fc0,$44c0,17, t_move-op_table 
that it equals the second word. a ee ae a 
; : : CW 0 ,$4800,17, t_nbed-op_table 
If it dows, we have the correct instruction. The dew  $ffe0,$4840,17, t_pea-op_table 
next two words give the instruction type and a dew  $ffc0,$4ac0,17,t_tas-op_table 
pointer to its textual representation. de.w  $ffc0,$4ec0,17, t_jmp-op_table 
de.w  $ffc0,$4e80,17,t_jsr-op_table 
¥ SRSSSr SSS SS SSeS Sl SS SSS TSS SES SS SSS SSS SITS SSS SSS STSSsSS== 
% Masks table type18 dew $00, $0000,18, t_ori-op_table 
& sccersccscnrsssrrssrrrssstsrs tesserae ssssssss2====sss2225 de.w $£f00, $0200, 18, t_andi-op_table 
* This table is the central part of the disassembler. de.w $££00,$0400,18, t_subi-op_table 
* There is a single entry for each instruction and the format is: de.w  $££00,$0600, 18, t_addi-op_table 
x de.w $ff00,$4200,18, t_clr-op_table 
* mask - word - The mask value which is ANDed with the op de.w — $££00,$0c00, 18, t_empi-op_table 
* code to give .. de.w  $ff00,$0a00,18, t_eori-op_table 
¥ result - word - The expected result of ANDing the op code de.w — $££00,$4400, 18, t_ neg-op_table 
¥ with the mask de.w  $££00,$4000,18, t_negx-op_table 
* type ~ word - the instruction type (see text) dew — $££00,$4600, 18, t_not-op_table 
¥ offset - word - Offset into optable for text of instruction. de.w — $££00,$4a00, 18, t_tst-op_table 
% SRS SS SSP SSS SRS RS SS LLL SIA SS SSS SSR SVL LS SS SSL SSS SSS SSS Ss= 
nasks equ * type_19 de.w  $£100,$5000,19, t_addq-op_table 
type_0 dew  $ffff,$4afc,0,t_illegal-op_table de.w — $£100,$5100,19, t_subq-op_table 
de.w  $ff£f,$4e70,0, t_reset-op_table 
dew = - $F F Ff, $4e71,0, t_nop-op_table type_20 de.w  $£f00,$0800,20,t_b-op_table 
de.w  $ff ff, $4e73,0, t_rte-op_table 
dew  $ffff,$4e75,0, t_rts-op_table type_21 de.w  $f100,$0100,21,t_b-op_table 
dew $ffff,$4e76,0, t_trapv-op_table 
dew  $fff,$4e77,0, t_rtr-op_table type_22 dew  $f1c0,$4180,22, t_chk-op_table 
de.w $fic0,$81c0,22,t_divs-op_table 
type_l de.w  $£f££,$023c,1, t_andi_ccr-op_table de.w $100, $80c0, 22, t_divu-op_table 
de.w $f fff,$0a3c,1, t_eori_ccr-op_table de.w  $f1c0,$c1c0, 22, t_muls-op_table 
de.w  $ffff,$003c,1,t_ori_ccr-op_table de.w  $f1c0,$c0c0,22, t_mulu-op_table 
type2 dew —$fff'f,$027c,2, t_andi_sr-op_table type_23 dew $100, $41c0,23,t Lea-op_table 
dew  $ffff,$0a7c,2, t_eori_sr-op_table 
de.w =: $F FFF, $007c ,2, t_ori_sr-op_table type_24 de.w — $£000, $4000, 24, t_add-op_table 
de.w  $ffff,$4e72,2, t_stop-op_table de.w — $£000,$c000, 24, t_and-op_table 
de.w  $£000,$8000,24,t_or-op_table 
type3 de.w  $fff8,$4e58,3, t_unlk-op_table de.w $000, $9000, 24, t_sub-op_table 
de.w  $f££8,$4840,3, t_swap-op_table 
type_25 de.w $£000,$b000,25, t_type_25-op_table 
type_4 de.w fff0,$4e40,4, t_trap-op_table 
u ee type26 de.w —‘$£0c0,$50c0,26, t_s-op_table 
type_ de.w fff8,$4e50,5, t_link-op_table 
me? al a d type27 de.w ‘$80, $4880, 27, t_novem-op_table 
type_6 de.w f0f8,$50c8,6, t_db-op_table 
vps ; ; type_28 de.w $cc, $0040,28, t_movea-op_table 
type_? de.w  $f£00,$6100,7,t_bsr-op_table 
type_29 de.w  $c000,$0000, 29, t_move_dot-op_table 
type_8 de.w  $f000,$6000,8,t_b-op_table 
type_30 de.w  $f£130,$d100,11,t_addx-op_table 
type_9 de.w  $£fb8,$4880,9, t_ext-op_table de.w  $f130,$9100,11, t_subx-op_table 
type.10  de.w —$f'100,$7000,10, t_moveq-op_table type31 de.w $0000, $0000,30, t_de_w-op_table 
type_ii de.w  $f1f0,$c100,11, t_abcd-op_table ; : 
de.w  $£1f0,$8100,11, t_sbed-op_table That is the end of the masks table. Following on 
we have the op-codes table. This is called 
typet2  de.w -$f£0,$4e50,12, t_move_usp-op_table ‘OP_TABLE’ and holds a textual representation of 
type13 de.w $138, $b108,13,t cupm-op_table the individual instructions. 
typet4  de.w — $£100,$c100,14, t_exg-op_table Take care to get the spaces and dots in the 
correct places. if you are confused, the value in 
de. £008 , $0008, 15, ~op_tabl f \ . 
mee) Se nae eee the ‘DCW’ above the text is the number of 
type16  de.w  $f000,$e000,16, t_type_16-op_table characters in the text. Hopefully, the conversion of 
; this file from my text into QL Today's print 
type_17 de.w  $ffe0,$40c0,17, t_move_sr-op_table h ’ | 
de.w $ffc0,$42c0,17, t_move_ccr-op_table shouldn't corrupt the layout! 
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& sccrsssscssssssssssssssssssssrssssssclsnesessss=Sssszszs= t_eori_sr dc.w q 


% Op_table de.b © ‘FORT #$! 
# sccrscssssesssssssstssssssrssrassssasstssssssssEss=sss= t_ori_sr ade.wW 6 
% This table holds the text for each instruction to be decoded. de.b ‘ORI #$! 
% There is one entry corresponding to an entry in the above table t_stop dew 867 
* but some entries may be duplicated here or two entries above de.b = ‘STOP #$! 
* may point to a single entry here. The format is: 
# tunlk dew 6 
* Size - word de.b = UNTK A! 
* text - bytes t_swap dew 6 
¥ BMRRTI RPE AI AMIR SE Ame I TTR SAV ILI TVS SHS SSI ol SSS SSS SSS SSS=ES=T== de.b 'SWAP dD 
op_table equ * 
tillegal dew 7 t_trap dew 6 
de.b  ‘ILLEGAL' de.b = ‘TRAP ## 
t_reset dew 5 
de.b = "RESET! t_link dew 86 
t_nop de.w 3 de.b "LINK At 
de.b ‘NOP! 
t_rte dew 3 tidb dew 2 
de.b = ‘RTE! de.b "DB! 
t_rts dew 3 
de.b = ‘RTS! t_bsr dew 3 
t_trapy dew 5 de.b = "BSR! 
de.b = ‘TRAPV' 
t_rtr dew 3 tb dew J 
de.b  =''RTR' de.b  'B' 3; Bee and BRA, BIST, BCHG, BCLR & BSET 
tandicer dew 7 t_ext dew 4 
de.b "ANDI #$! de.b = 'EXT. 
teoriecr dew 7 
de.b = "ORT #$' t_moveq dew 8 
toricer dew 6 de.b 'MOVEQ #$! 


de.b ORT #$' 
t_abed dew 5 
tandisr dew 7 de.b "ABCD ! 
de.b = AND. #$! 


Happy Birthday to us... 


..ust Words! just starting our sixth trading year. 
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5 


‘ADDQ.! 


y) 
‘SUBQ.' 


4 


'CHK t 


y 


'DIVS ! 


y 


‘DIV ! 


5 


'MULS t 


y) 


"MULU ' 


4 


"TRA t 


3 


‘app! 


3 


‘AND! 


a 
ret 


6 


5 No text for type 25! 


'MOVEM. ' 


6 


"MOVEA. ' 


5 


"MOVE. ! 


) 


"ADDX.' 


y) 


‘SUBX. ' 


y) 


'DC.W 4 


And that is about it for this session. Next issue, 
we are back to the tutorial again where we wil 
take a peek at QDOS and discuss extending 
SuperBasic with new procedures and functions. 


tsbed dew = 5 tLaddq de.w 
de.b 'SBCD ! de.b 
t_subq de.w 
tmoveusp dew 5 de.b 
de.b = ‘MOVE 
t_chk de.w 
t_cmpm dew 95 de.b 
de.b 'CMPM. ' tdivs de.w 
de.b 
texg dew = 4 tdivu dew 
de.b = EXG de.b 
t_muls de.wW 
t_movep dew 6 de.b 
de.b 'MOVEP, ' tolu de.w 
de.b 
ttypel6 dew 0 ; No text for type 16! 
t_lea dew 
tmovesr dew 8 de.b 
dc.b = ‘MOVE SR,! 
tmove.ccr dew 9 tadd dc.w 
de.b ‘MOVE CCR, ' de.b 
t_move dew 4 t_and de.w 
de.b = ‘MOVE! de.b 
t_nbed dew 4 tor de.w 
de.b 'NBCD! de.b 
t_pea dew 3 t_sub de.w 
de.b =‘ PEA! de.b 
t_tas de.w 3 
de.b =‘ TAS! ttype25 de.w 
t_jmp dew 3 
de.b ‘IMP! ts de.w 
t_jsr dew 3 de.b 
de.b =‘ JSR! 
t_moven de.w 
tori dew 4 de.b 
de.b ‘ORI. ! 
t_andi dew 5 t_movea de.w 
de.b "ANDI, ! de.b 
tsubi dew 5 
de.b ‘SUBI.! t_move_dot de.w 
t_addi dew = 5 de.b 
de.b = ‘ADDI. ' 
telr dew 4 t_addx dew 
de.b 'CIR.! de.b 
t_empi dew 5 t_subx de.w 
de.b = CMPT.' de.b 
t_eori dew = 5 
de.b = 'EORT.! t_de_w de.w 
t_neg dew 4 de.b 
de.b = 'NEG.' 
t_negx dew 5 
de.b = 'NEGX.' 
t_not dew 4 
de.b = ' NOT." 
t_tst dew = 4 
de.b = ' TST. 


See you then. 


Gee Graphics! (On the QL?) - part 15 


Lines and Planes in 3 space 


Herb Schaaf 


In the Jan-Feb 1999 issue of QL 
Today there was a discussion 
of 3D space coordinates in 
GG#8 and the cover disk that 
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came with the Mar-Apr 1999 
issue had a program FIT9c5_bas 
referred to in GG#9 with some 
FuNctions and PROcedures for 


Lines and Planes in 3D. As | will 
refer to FIT9c5_bas in. this 
article | invite you to find the 
disk, unzip the files and load it. 


Directions in 3 space 

Several terms in analytical geo- 
metry begin with direction. One 
is ‘direction-number’, another is 
‘direction-cosine’ and yet ano- 
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ther is ‘direction-angle’. All are 
used to describe and define 
lines and planes in 3 dimen- 
sions. 


Lines in 3D space 

We can set a point in 3 space 
as a triplet of numbers for the 
x, y, and z coordinates. We can 
then set other points with other 
triplets. For example we could 
have a first point as (3, 5, 7) and 
a second point as (6, 9, 19}. A 
3D line would passes through 
both points and a 3D line seg- 
ment connects the two points. 


Direction numbers: a,b, and c 
These are the signed distances 
along the x, y, and z directions 
respectively between any two 
points on a line in 3 space. Let 
d be the distance between the 
two points. Since 

d*d = a*a + b*b + c¥c, 

dis equal to the square root of 
the sum of the squares of a, b 
and c. 

In the example given the direc- 
tion numbers from the first 
point to the second point are 3, 
4, and 12. The direction num- 
bers from the second point to 
the first point would be -3, -4, 
and -12. The distance between 
the two points would be the 
square root of (9 + 16 + 144), so 
d= 13. 


Direction cosines: lambda, mu, 
and nu (aka |, m, and n) 
For the example given: 
lambda=a/d, mu=b/d, and nu=c/d. 


or 
l=3/13, m=4/13, and n=12/13. 
The direction cosines for the 
x-axis are 0, 1, and 1. The direc- 
tion cosines for the y-axis are 
1, 0, and 1. The direction co- 
sines for the z-axis are 1, 1, and 
0. Parallel lines in space have 
the same direction cosines. 


Direction angles: alpha, beta, 
and gamma 
For a line in 3 space these are 
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the angles between the line 
and the x, y and z axes re- 
spectively, 

For the example given the di- 
rection angles are: ACOS(3/13), 
ACOS(4/13), and ACOS(12/13). 
So alpha = 76.7, beta = 7211, 
and gamma = 22.6 degrees; or 
alpha = 134, beta = 1.26, and 
gamma = 0.39 radians. 

The direction angles for the 
x-axis are 0, 90, 90 degrees. 
The direction angles for the 
y-axis are 90, 0, 90 degrees. 
The direction angles for the 
z-axis are 90, 90, 0 degrees. 


PROCedure line_n3space 

In FIT9c5_bas take a look at 
lines 25130 to 25400, thank 
goodness for the REMarks! To 
try it out DIM one_line(2,3), an 
array of 2 points each having a 
triplet (xyz) of values. Assign 
values of xy, and z for points 1 
and 2 of the array. 

Then enter = ‘line_n3space 
one_line(i), one_line(2)". The 
QL will work out the values 
which you can examine by 
entering “list_array AL3S”. 


PROCedure parameterize 

In FiT9c5_bas take a look at 
lines 15700 to 15580. To try it 
out DIM param_iine(i,3,3), an 
array with 1 line, 2 points each 
(plus a 3rd register for the 
direction cosines), and a 
triplet(xy,z) of values. Assign 
values of xy, and z for points 1 
and 2 into the array. Then enter 
“parameterize param_iine, 1”. 
Examine the values by entering 
‘list_array param_line’. 


Two lines in 3 space 

lf they meet we can find the 
point of intersection, but in 3D 
they may be “skew lines” and 
not meet, however we can find 
where they come closest to 
each other If they are parallel 
they could be identical lines or 
lines that will never meet in the 
Euclidean Cartesian system. 


PROCedure linesN3space 

In FiT9c5_bas take a look at 
lines 13860 to 14780, some- 
thing done in 1996; thank 
goodness for the REMarks! To 
exercise the procedure RUN (or 
GOTO) 26420 and enter the 
values as requested. After en- 
tering the last value, the QL will 
work out the situation. You can 
then enter as a command line 
‘list_array L3S" to see the array 
of values. | should try to im- 
prove this PROCedure; when 
the two lines are parallel | 
should find the distance and 
direction from one line to the 
other and the common plane if 
the lines are not identical. 


Planes in 3D space 

One form for describing the 
plane is 

A*¥x + B*y + C¥2+D =0 
Another way to locate or "fix" a 
plane in 3 space is by defining 
its normal and distance from 
the origin. The normal is a line 
perpendicular to the plane. 
Since the normal is a line it can 
be described by its direction 
cosines. The origin is where 
X=y=z=0, 

and we can use p as the dis- 
tance from the origin to the 
plane. 

Given 3 non-colinear points in a 
plane we can determine the 
equation of the plane, and para- 
meterise the normal to the 
plane. 


Plane_frm3pts 

In FIT9c5_bas take a look at 
lines 14820 to 15660, and lines 
24450 to 24480, something 
else done in 1996; again thank 
goodness for the REMarks! In 
line 24760 change 17520 and 
17580 to 24670 and 24720. 
Insert line 24865 PAUSE. To 
exercise the procedure RUN (or 
GOTO) 24460. The QL will 
work Out the values and pause 
between the DATA sets. You 
can enter as a command line 
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“\st_array EqnPlane” to see the 
array of values. 


Point to Plane? 

In FIT9c5_bas take a look at 
lines 16510 to 16600 To exer- 
cise the FuNction enter the fol- 
lowing: 

“ot2p! = Pt_to_plane(0,0,0,1,1,1,-1) 


Then “PRINT pt2pl’ or "PRINT 
PTP” will show the distance. In 
truth the answer seems to be 
the distance from the plane to 
the point, rather than from the 
point to the plane, so a change 
of sign is in order The things 
you find when you revisit an- 
cient writings! 


Things | haven't done yet, but 
hope to do 
Given two parallel lines in 3 


space, determine if they are 

identical, if not identical then 

find the common plane and 

distance and direction from one 

line to the other. 

intersection of a line and a 

plane in 3D 

1) the line might be in the plane 
(and thus parallel to it) 

2) the line might be parallel to 
but out of the plane 

3} the line intersects the plane 


intersection of two planes in 3D 

1) could be the same plane 

2) could be parallel and not 
meet 

3) meet in a line 


lf anyone has already worked 
out any of these, why not show 
and tell the rest of us how to 
do it? 


Steve Poole responded to the 
‘cutting corners’ of GGH#14 by 
sending his “CONICS_BAS’, 
based on a program which has 
been in a collection of BASIC 
DEMO'S from the QUANTA Ii 
brary on DISK MD 01 since May 
1993. His program draws a 
smooth connecting curve 
THROUGH all of the random 
points in a collection. He also 
sent a program "BIKE_BAS’ 
using the algorithm to create 
"Chris Boardman’, a_ neat 
graphic of a racing cyclist. | 
hope he will be kind enough to 
explain the logic behind the 
algorithm and the thought 
process he went through in 
developing it back in 1985 and 
1992. 


Next time? 


Letter-Box 


Stephen Poole writes: 

Dear Dilwyn, 

Thank you for QLToday volume 
4, issue 5. | am beginning to re- 
gret that there is not a cover 
disk with every issue. Herb 
Schaafs “Gee Graphics’ arti- 
cles are still as lengthy as ever 
and it will take a lot of patience 
if | decide to wait for the next 
disk, or type in his listing for 
that matter Precisely, in part 14, 
he asks us to consider a zig- 
zagging collection of connec- 
ted lines with their vertices, 
and hopes to get segments 
beginning to look more like a 
smooth curve. Well about ten 
years ago | needed the same 
sort of routine to draw con- 
tours on maps, and not finding 
any on offer | began to tackle 
the problem myself, Some ma- 
gazines showed techniques for 
tracing simple splines and Be- 
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zier curves, but these do not 
pass through the vertices. 

Finally | developped a program 
which satisfied my needs, and 
sent a detailed and commen- 
ted listing to Quanta for the 
library. The program, CONIC_bas 
is quite long as it first calcu- 
lates all the relations between 
the vertices, then from per- 
spective computes the elliptic 
curves in all possible sectors. 
There are two minor bugs 
which | can fix, but they only 
show up once in a blue moon. 
Some of the curves may seem 
a little pointed, but a close 
examination of the vertices 
shows that this is necessary, 

There is enclosed a copy of 
the CONIC_bas program that 
Herb desires, with a modified 
version BIKE_bas to demon- 
strate Chris Boardman in filled 
vector graphics. Please could 


you forward all this to Herb as | 
do not have his address. The 
listings are crammed pretty 
tight as | kept the number of 
lines as short as possible 
during the development stage 
to help memorisation. At the 
moment | am considering a 
complete rewrite as, as such, 
they are slightly indigestible. 
Regarding Q40 Colour Drivers: 
Will they become available to 
SMSQ/E SuperGoldCard users 
as has been suggested? An 
article on QL monitors would 
be opportune, as there has 
been little detail on this for a 
long time. 

several long letters arrived by 
email concerning QL MIDI, sug- 
gesting | write a program to 
use QL BEEPs. This has al- 
ready been done and sent to 
Quanta. Probably | shall get in 
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TF Services 


A major hardware upgrade for the QL 

All Hermes features (working serl/2, independent 
baud rates/de-bounced keyboard/keyclick) PLUS full 
19200 throughput on ser]/ser2 not affected by sound 
IBM AT keyboard interface (plus foreign drivers) // 
HIGH SPEED RS232 industry standard two-way 
serial port. 4800cps throughput (supergoldcard - 
qtpi - zmodem) at 57600bps // THREE low speed 
RS232 inputs (1200 to 30bps)- incl SERIAL MOUSE 
driver. Other uses include RTTY/graphics tablet etc // 
3 spare I/O lines (logic) with GND/+5V // Capslock/ 
scrollock LED/Turbo/keylock connectors // 1.5k user 
data permanently in EEPROM 


All this on a professional board about twice the size of 


the 8049 co-processor it replaces 
Cost (including manual/software). £90 (£92/£87/£90) 


TBM AT UK layout Keyboard £22 (£24/£23/£27) 
Serial mouse £11 (£13/£12/£14) 
Capslock/scrollock LED £1 (£1.50/£1/£1.50) 
Keyboard or mouse lead £3 (£3.50/£3/£3.50) 
High speed serial (ser3) lead £4 (£4.50/£4/£4.50) 


——._- SuperHermes LITE ___ 


All Hermes features (see above) + an IBM AT 
keyboard interface only. Entry level superHermes, 
Cost (incl keyboard lead)...£53 (£55.50/£5 1/£53 50) 


MINERVA RTC (MKID) + battery for 256 bytes ram. 
CRASHPROOF clock & IC bus for interfacing. Can 
autoboot from battery backed ram. Quick start-up. 


f OTHER FEATURES COMMON TO ALL VERSIONS 


DEBUGGED operating system/ autoboot on reset of 
power failure/ Multiple Basic/ faster scheduler- graphics 
(within 10% of lightning) - string handling/ WHEN 
ERROR/ 2nd screen/ TRACE/ non-English keyboard 
drivers/ “warm” fast reset. V1.97 with split OUTPUT 
baud rates (+ Hermes) & built in Multibasic. 
First upgrade free. Otherwise send £3 (+£5 for manual if requd). 
Send disk plas SAE or two IRCs 


MKL..£40 (£41/£40/£43) MIKIL..£65 (£66/£63/£67) 


QL REPAIRS _(UK only) ___ 


Fixed price for unmodified QLs, excl microdrives. QLs 
tested with Thorn-EMI rig and ROM software. 


£27 incl 6 month guarantee 


: outside) & QL motherboard in tower case. 


; sampling (to 5 KHz), x/y plotting 


—_- 9L RomDisq _ 
Up to 8 mbyte of flash memory for the QL 
A small plug in circuit for the QL’s ROM port (or 
Aurora) giving 2, 4 or 8 mbytes of permanent 
storage - it can be thought of as a portable hard disk 
on a card, and reads at some 2 mbytes per second. 
Think of it - you could fully boot an expanded QL, 
including all drivers/SMSQ etc off RomDisg at hard 
disk speed with only a memory expansion needed. 
2 mbytes RomDisq, £39 (£41£37/£40) 
4mbytes RomDisq £65(£66/£63/£67) 


8 mbytes RomDisq £98 (£100/£95/£99) 
Aurora adaptor. £3 (£3.50/£3/£4) 


MPLANE 


1 A low profile powered backplane with ROM port if 


A three expansion backplane with ROM port included for 
RomDisq etc. Aurora can be fitted in notebook case and 
powered off single 5V rail - contact QBranch for details. Two 
boards (eg Aurora and Gold Card/Super Gold Card/Goldfire 
fixed to base. Suitable for Aurora (ROM accessible from 
Specify ROM 
facing IN towards boards, or OUT towards back of case. 


COSt......00000 asstacadsvsaseute £34 (£36/£33/£35) 


ZC INTERFACES 
Connects to Minerva MKII and any Philips °C bus 


Power Driver Interface 16 1/O lines with 12 of these used to 
control 8 current carrying outputs (source and sink capable) 


2 amp (for 8 relays, small motors) £40 (£43/£38/£44) 
4 amp total (for motors etc) £45 (£48/£43/£50) 
Relays (8 3a 12v 2-way mains relays (needs 2a power 
£25 (£28/£23/£27) 

Parallel Interface Gives 16 input/output lines. Can be 
used wherever logic signals are required ..£25 (£28/£23/£27) 
Analogue Interface Gives eight 8 bit analogue to 
digital inputs (ADC) and two 8 bit digital to analogue 
outputs (DAC). Used for temp measurements, sound 
£30 (£31.50/£29/£30) 
£10 (£10.50/£10/£11) 
£10 (£10.50/£10/£11) 
£2 (£2.50/£2/£3) 


Temp probe (-40°C to +125°C) 
Connector for four temp probes 
Data sheets 


Satie I SPARES | 


£24 (£25/£24/£27) 

£3 (£3.50/£3/£4) 

Circuit diagrams £3 (£3.50/£3/£4) 
68008 cpu or 8049 IPC £8 (£8.50/£7.50/£9) 
8301/8302 or JM ROM or serial lead..£10 (£11.50/£10/£11) 
Power supply (sea mail overseas) £12 (£17/£16/£21) 


Prices include postage and packing (Airmail where applicable). Prices are: UK (EC/Europe outside EC/Rest of world). Payment by cheque drawn on bank 


with UK address, debit card/Mastercard/Access/Kurecard/pastal order or CASH! (No Eurocheques). SAE or IRC for full list and details 


26 Sep 99 


29 Longfield Road, TRING, Herts, HP23 4DG 


Tel: 01442-828254 


Fax/BBS: 01442-828255 


tony@firshman.demon.co.uk — http://www.firshman.demon.co.uk 
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touch directly with Al Boehm 
after the february holidays, and 
send a disk with example mu- 
sic, but my program can only 
handle duo's, not full orches- 
tras. 

For CueDark, | have dug deep 
into my old microdrive stock of 
programs and found one or 
two routines which may help 
people twiddle their thumbs. 
The programs are Snow- 
flake_bas, Text_Leap_bas and 
Hash_bas. It is regrettable that 
SMSQ cannot access micro- 
drives, as this precludes auto- 
loading it at start-up. | have 70 
tapes which | still need to 
access at regular intervals. 
Instead of copying all my tapes 
to disk, | have copied my micro- 
drive catalogue to disk, as this 
runs smoother 


Reply from Jochen regarding 
colour drivers: the colours do 
not depend entirely on having 
a (Super)GoldCard, you have 
to have an Aurora. Roy Wood 
has loaned Tony Tebby an 
Aurora system to produce the 
colour drivers for the Aurora, 
so hopefully we're looking 
forward to them pretty soon. 


Stephen Poole also writes: 

[| Another point | found 
confusing was in Al Boehm's 
article on Midi Sounds. He said 
that “Simon Goodwin's key- 
words via the QL NET port 
could handle a full orchestra’ 

| take this to mean that the 
sound is not produced on a QL, 
as further on he indicates that 
the QL can handle a chord of 
three 64th notes played toge- 
ther 

Then he states that the QL can 
resolve time only down to a 
video frame which is 1/50 
second. This is quite evidently 
false as Beep durations can be 
much shorter and rests can be 
programmed as short as requi- 
red by using FOR loops. | have 
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bought a book on MDI pro- 
gramming and am very sur- 
prised that Simon Goodwin has 
been able to convert QL 
BEEPs to MIDI format at all. 
More news please. 


Simon N. Goodwin replies: 
MIDI and via the QL NET port 
implies the QL is controlling 
not generating the sound. 
BEEP can indeed resolve 
shorter priods but the QL 
must poll the IPC (a time-con- 
suming process) and is at the 
mercy of IPC (or emulation) 
variations. FOR loops are 
hopeless for timing, depend- 
ing on program size, CPU, 
ROM version, other tasks - 
this is a multi-tasking system 
and QL MIDI keeps it that way. 
Indeed it's possible to use 
Xchange and play MIDI - in 
time! - simultaneously. 

BEEP is nothing to do with it 
Nowhere did we connect 
BEEP and MIDI. That is Steve's 
invention, mot ours, and the 
basis of his misunderstanding. 


Al Boehm replies: 

MIDI (Musical Instrument Digi- 
tal Interface) is, per se, just a 
hardware and format stan- 
dard. It specifies the hardware 
connections - plugs, pins, ca- 
ble, etc. - that are to be used 
between digital musical instru- 
ments and their associated 
components which in our case 
is a QL computer In a stroke 
of genius, Simon thought out a 
way that the QL NET port 
could emulate the MIDI hard- 
ware standard. Thus a simple 
plug can be made to connect 
the QL NET port to a Digital 
Musical instrument such as 
musical keyboard so that the 
QL can control the musical 
keyboard and make it play. 
You are right in your assump- 
tion that the QL does not make 
any sound; it just sends data 
to the music keyboard which 


generates the sound. MIDI can 
be used to send data to other 
devices that use the MIDI 
standard. For example, boxes 
that control stage lighting or 
mixers that change the volume 
for sets of microphones. When 
MIDI is used to make music, a 
synthesizer (synth for short) 
is needed to change the MIDI 
data into sounds which are 
played on speakers or recor- 
ded. Thus, the musical key- 
board | mentioned above must 
have a MIDI IN port to receive 
the data and a synth to gene- 
rate the sounds. Synths are 
also sold separately without a 
keyboard. One can drive a 
synth with a computer or with 
other instruments that have 
special MIDI pickups. | have 
one of these for my guitar 
Also to make things more ver- 
satile, (complicated?) there are 
musical keyboards that have 
no synth built in. These are 
called controllers and merely 
send MIDI signals through a 
MIDI OUT port so that some 
other synth (or recording de- 
vice) can generate the sounds. 
MIDI is also a format standard. 
Sets of numbers sent as 
bytes over the MIDI hardware 
specify what is to be done. 
For example start a note, or 
stop a note, or use a particular 
instrument sound. Many books 
on MIDI give this format Also 
a lot of it is given in the 
downloadable files from the 
NESQLUG web site under 
MIDI: 
http:/boehm.home.hiwaaynet 
The boehm actually stands for 
my son Bill who is the web- 
master and yes there are two 
a’s in hiwaay! Many of the 
combinations of numbers have 
been made easy to use by a 
large set of keywords - 
NOTE_ON, NOTE_OFE 
MIDI_MUTE, etc. - developed 
by Simon. These are explained 
in his DIY_MIDI manual which 
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is also on the NESQLUG web 
site. MIDIPlayer reads in a 
SMF (Standard MIDI File) and 
sends the MIDI signals out of 
the QL NET port at the proper 
time. Thus we come to your 
second main question. You are 
right. The QL can resolve time 
to less than a 20 millisecond 
interval. But not reliably. The 
QL clock through the DATES 
function only gives time to the 
second. Simon's timing key- 
words give time to the video 
frame rate (1/50 second = 20 
milliseconds) (1/60 second 
for US machines). Some tricks 
- FOR loops - can be used to 
estimate time to a smaller in- 
terval. However, in a multi-task- 
ing machine, they are not com- 
pletely reliable, plus they take 
compute time. | worried about 
this quite a bit until | listened to 
MIDIPlayer play many songs. 
Now | am satisfied that it is 
not a significant problem. The 
proof of the pudding is in the 
eating. Try MiDiPlayer your- 
self All the software is free- 
ware or cardware (send a 


posicard to Simon Goodwin). 
You will need a synth, proba- 
bly a musical keyboard, with a 
MIDI IN port. One with the 
GENERAL MIDI (GM) logo is 
preferred although earlier 
MIDI will work. Roland GS and 
Yamaha XG are extensions of 
General MIDI and play GM 
without any trouble. Make sure 
it has a MIDI IN port! Simon 
bought an old keyboard with- 
out a manual ai a garage sale. 
It was invaluable for debug- 
ging the DIY_MIDI keywords, 
but its limitations are quite 
noticeable in the type of music 
that can be played. You will 
need to make a MIDI/NET port 
cable. Directions are on the 
NESQLUG web site. It only re- 
quires two wires to be sol- 
dered - no chips or resisters 
or anything like that. As long 
as you know which end of a 
soldering iron to pick up you 
can do it yourself If you have 
zero skill at soldering, Tony 
Firshman will make you one 
for a small fee. The best part 
is that even with minimal pro- 


Time to Decide - Re-visited 


Robin Barker 


There have been, to put it midly, 
some interesting responses to 
my original Time to Decide let- 
ter Firstly, | must make clear 
there is no planned agenda to 
turn Quanta into a multiplatform 
group. There has been no sug- 
gestion that Quanta’s current 
funds would be used to sup- 
port other platforms, nor has 
there been any suggestion we 
are forsaking the QL. In fact, 
quite the reverse. | consider the 
survival of the QL and Quanta 
to be the prime motives. 

There has been some criticism 
that | am only interested in the 
future of Quanta for Quanta’s 


QL loday 


sake. This | consider to be a 
little odd. | am after all, the cur- 
rent chairman and as such 
must surely seek and promote 
the interests of Quanta mem- 
bership majority. The way to 
seek opinions is through the 
magazine since not all Quanta 
members are on the Net, hence 
the Time to Decide letter The 
letter was purposely designed 
to kick-start a debate, the ob- 
jective obviously being fulfilled. 
Phil Jones asked whether the 
committee have pursued a pre- 
vious idea to increase member- 
ship that involved mailing let- 
ters to ex-members asking 


gramming skill, you can gene- 
rate some neat sounds. The 
source code for MiDiPlayer as 
well as for the DIY_MIDI key- 
words is on the NESQLUG 
site. Both are loaded with 
comments. | have a Yamaha 
PSR-510, a mid level musical 
keyboard synth which is 
GENERAL MIDI With it, can 
MiDiPlayer play a full orches- 
tra? Yes, it can, and it is very 
sweei. 

The DIY_MIDI has nothing to 
do with BEEP However, your 
mention of it has caused me 
to think that MIDIPlayer can 
read in SMF which are avai- 
lable for many songs. Instead 
of MIDIPlayer sending MIDI 
out, it could send all note 
starts and stops to BEEPBEEP 
would not do justice to many 
songs but something like 
"Flight of the BumbleBee’ 
which is all one instrument, 
could sound very interesting 
when played just by BEEP Let 
me know if you would like to 
work on such a project. I'll 
help you. 


why they left Quanta and en- 
ticing them to rejoin. This was 
tried and proved to be unsuc- 
cessful. 

| suspect the majority of mem- 
bers leaving Quanta fall into 
two groups. The first will have 
given up computers comple- 
tely, for reasons that would in- 
clude health etc. The second 
will have moved to other plat- 
forms in favour of the QL. | 
believe we should try to en- 
courage this group to stay, but 
how? If we could maintain their 
interest in Quanta, therefore 
keeping them in touch with the 
QL, they may, for example, end 
up purchasing an emulator! It is 
surely better to have the QL on 
the shelf rather than out the 
window. 
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To pretend PC's etc., don't exist 
is banal. Not only do a signifi- 
cant number of QlLers use 
other platforms as a matter of 
course, many QDOS based 
systems are now run on other 
platforms. It therefore follows 
users also have an interest in 
those other platforms. Do we 
accuse those who run QDOS 
type systems on a PC as being 
deserters of the QL? Of course 
not! Why not in this case, 
attend to their interests. | would 
guess as time goes on, more 
and more QDOS based sys- 
tems will be run on other plat- 
forms, mainly the PC. Times 


have changed. No longer is the 
QL isolated in its black box. 
The point is, do we change? 

As the QL user base continues 
to decrease development be- 
comes more difficult, especially 
hardware which becomes in- 
creasingly expensive as de- 
mand falls, and like it or not, 
demand for updated QL pro- 
ducts is the key to the QL’s 
future, for without this, the QL 
will become an antiquated toy. 
This is the reality, so what are 
the options? Do we attend to 
members interests in other plat- 
forms via the magazine? (For 
those who would not wish to 


read any such articles, you sim- 
ply skip the page just like any 
other magazine you read) Do 
we invite other platform users 
into the fold so they at the very 
least, become acquainted with 
the QL? or what? You tell me. 
The QL 2000 show in October 
will feature a debate on this 
subiect on the Sunday mor- 
ning. The outcome of that de- 
bate, taken together with your 
correspondence, will be crucial. 
You are the Members. You 
Decide. 


Robin Barker 
Chairman, Quanta 


Do you have comments, questions, other kinds of feedoack? Just write - 
to us and we will try to help or contact the authors. Stephens letter has 


inspired Al, and the result of his feedoack comes next: 


MIDIPlayer 2 


Al Boehm 


After much testing, delays, and additions, MIDI- 
Player 1 went out on 8 December 1999. The next 
day | thought | would download some MIDI Christ- 
mas music for the season. | found some good 
ones. loaded them up, but they did not work! 

A good thing | had MIDIView. This a SBasic pro- 
gram | wrote to decipher SMF (Standard MIDI 
Files). SMF is the standard format for storing MIDI 
data on disk. Music stores sell MIDI songs on disk 
or CD and when MIDI songs are downloaded from 
the web, they are in SMF format. MIDIView reads a 
SMF and prints what it interprets each MIDI event 
to be. 

In less than a minute, | Saw what the problem was. 
In SMF MID! events generally consist of three 
parts: a time, a status byte, and data bytes. The 
status byte indicates what is to be done and how 
many data bytes follow. There are several excep- 
tions to the three part rule. One of the most com- 
mon is what is termed ‘running status’. This 
means that the status byte (which is always 
greater than 127) is left out. Instead use the status 
from the previous event on the same track. 
MiDIPlayer 1 allowed for running status on SMF 
type 0 which is limited to one track. SMF type 1 
uses multiple tracks. Usually, but not necessarily, 
each track is for a separate instrument. For exam- 
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ple, track 1 for clarinet, track 2 for trumpet, track 3 
for bass, track 4 for drums, etc. Now | thought 
who would want to run status with multiple tracks. 
The clarinet needs a different status than the 
trumpet and so on. 

Well | was right in the sense that you can not run 
status out the NET port when instruments are 
intermixed. However, on the SMF file, you can 
save bytes by storing the events in a run status 
mode if the same instrument is used on a track. 
Thus, track 1 would have one status byte at the 
Start to let you know it was for the channel 
assigned to the clarinet and from then on nothing 
but time and data bytes. 

Of course, in sending MIDI data out the NET port, 
you would have to add the proper status byte 
anytime another instrument came in-between 
your last use of the clarinet. 

Well a couple of IF statements could do the trick. 
The trouble is the QL could have trouble keeping 
up if the IF statements were added in the PLAY 
loop. It took me over two months two figure a 
way to check beforehand, and when needed, 
POKE status bytes into the time section of the file 
stored in ram. This is possible since SMF time (in 
beats per minute and fraction of a beat since last 
event} is recalculated into QL frames (1/60 se- 
cond) and stored separately in an array. The 
address in ram to the MIDI event was reset to the 
new status byte. Since this is all done beforehand, 
the PLAY loop did not become a bottleneck. 
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Operating since 1993 on a Sinclair OL from Utica, Michigan, USA 
Supporting ALL Sinclair and Timex users 
Message and File Areas for OL, Z88, Spectrum, TS2068, ZX81, TS1000 
Modem speeds 300 bps to 33.6k bps supported 
24 hour operation - call anytime 


310-254-9878 
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Thus MiDlPlayer 2 can now run type 2 SMF even 
if they run status on multiple intermixed tracks 
without any degradation in speed. Finally | could 
listen to Winter Wonder Land using my QL! 

If you haven't heard MiDlPlayer play, you are in for 
a treat. You do need a synth and several people 
have asked me what should they get. If a musical 
keyboard has the General MIDI logo it will do quite 
well. | have seen these in Catalogs as low as $130 
new. General MIDI requires 16 channels and up to 
24 simultaneous voices or 16 simultaneous melo- 
dy voices plus 8 for drums. However, almost any 
of the new musical keyboards that have a MIDI IN 
port have enough capability to work OK even if 
they are not General MIDI. But if you buy an older 
one at a yard sale make sure it is General MIDI or 
at least has a substantial number of channels and 
simultaneous voices. 

MiDIPlayer 2 \s available on the MIDI section of the 
NESQLUG web site 
http://boehm.home.hiwaay.net 

along with Simon Goodwin's DIY_MIDI keywords 
and documentation. Source code is available too. 
Also there are several MIDI documents including 
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“An Intro to MIDI. 

| have not put MiDIView on the NESQLUG web 
site since it needs some cleaning up and a manu- 
al before | would consider it presentable. 
However, it works, and | will send it to anyone 
who can use it. 

As nice as MiDlPlayer is, | consider it a very beau- 
tiful toy. My next planned project is to beef up 
MIDIView into an easy to use low level MIDI editor 
This capability is something | need. The high end 
MIDI editors for Mac, PC, etc. are available (usually 
expensive) but just do not have the capability to 
change a single byte. 

Of course, | thought | would finish MIDIPlayer in six 
weeks; if took nine months! So don't hold your 
breath! 

Oh, in answering Stephen Poole’s letter about 
MiDIPlayer and BEEPit occurred to me that MIDI- 
Player could be converted to use BEEPOf course, 
BEEP would not be melodious as a synth and 
would have trouble with multiple parts. But a solo 
part could be sounded by BEEP Is anyone 
interested in working on this project? I'd be willing 
to help. 
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A Quick announce- 


ment! 

This column was produced en- 
tirely on the Q 40 whichis now 
the main machine in The Q 
Branch HQ in Portslade. The 
shop and the shows will still do 
their business through the 
MinisQL because it is easier to 
transport and my Q 40 will be 
there to demonstrate its poten- 
tial but this is now my machine 
of choice for producing ad- 
verts and most QDOS /SMSQ 
use. 


Normal Service is 


resumed 

After the flurry of the New 
Year/New Century/New Milleni- 
um celebrations at the start of 
the year had died down we got 
down to some serious QDOS/ 
SMSQ_ business with three 
shows one after the other 
during February. First off Tony 
Firshman, Bill Richardson and 
myself attended the Radio Ral- 
ly in Cambridge, followed by an 
Eindhoven trek and finishing off 
with my own workshop in 
Hove. 

This could be a good year for 
workshops with several in the 
planning stage. Apart from the 
U.S. meeting there are others 
planned in Paris, Austria, Italy, 
and Ireland as well as the QL 
2000 meeting in Portsmouth in 
October. 

lf anyone is planning a show 
please send me the details so ! 
can include it on my website. 
Those of you who are online 
and want to check show de- 
tails can do so through the Q 
Branch website at: 
http://www.qbranch.demon. 
co.uk/websites/ 
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The Cambridge one was 
strangely curtailed and, having 
got up at some silly hour of the 
morning, and driven for two 
and a half hours to get there 
for 9.00am the show began 
packing up at 2.30pm. | apolo- 
gise to anyone who arrived af- 
ter that to find us gone. As it 
was a couple of QLers turned 
up after we had packed our 
stand away and both Tony and! 
had to dig out some of the 
stuff they wanted. 


Eindhoven 

This regular meeting is one of 
the places where some of the 
issues get thrashed out since it 
is a relaxed venue and always 
followed by a visit to the local 
Chinese Restaurant where tra- 
ders, programmers and some 
of the customers can have a 
general discussion. 

This meeting was enhanced by 
the presence of Tony Tebby 
and Peter and Claus Graf 
(thanks for the meal, guys). as 
well as several members of the 
French QL Club. Q 40s aboun- 
ded running three different ope- 
rating systems although mine 
was pretty much taken up for 
most of the day with our af- 
tempts to get LINUX running on 
it. We did make a few interes- 
ting discoveries about this (see 
the Q 40 section) and | did leave 
the venue with LINUX com- 
pletely installed on my machine. 
Eindhoven also saw the launch 
of SuQcess, Wolfgang Uhlig's 
front end for the DBAS data 
base system. | originally saw 
this in Eindhoven last year and 
was impressed then so | am 
very glad to see it released. | 
am even more pleased to see 
a new programmer surfacing. 


We need more! 
Wolfgang Lenerz was also 
there taking notes and sugges- 
tions for improvements to his 
Agenda program. It is good 
that programmers listen to their 
customers in this way and 
make the kind of changes that 
are needed to improve the pro- 
duct. Eindhoven is a long way 
from Hove but always worth 
the journey. 


Hove 

My usual thanks go out to all of 
those who attended or helped 
the Hove show at the end of 
February. This is always a hard 
show for me because | have to 
be both trader and organiser. 
When we arrived we found that 
there was a wedding reception 
going on in the other room and 
there were not enough tables 
available. This is despite our 
having booked three months in 
advance and specified that we 
would need lots of tables. Tony 
Firshman and | went on a raid 
and stole tables from various 
places when the lazy hotel staff 
could not be bothered to help 
us. | think | shall be looking for a 
new venue for next year's 
show. 

Enrico Tedischi was at this 
show displaying his collection 
of all of Sinclair's products (he 
couldn't get his C5 down the 
Stairs) and he will be attending 
the big two day event in Ports- 
mouth later this year 

It was a shame that ill health 
prevented Rich Mellor and Di 
wyn Jones from attending the 
show. Rich is in bed with a 
nasty stomach condition which 
does not allow him to sit up for 
longer than an hour at a time. 
Get well soon Rich. 


A Few Old Chestnuts 

Many people have complained 
in the past about BOOT file lis- 
tings but there is a place for 
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New improved printer drivers, providing up to 720 dpi 
printout in full colour from all programs written for 
use with ProWesS, such as LineDesign and Paragraph. 
Work on all Epson inkjet printers which support Binary 
mode compression (740,850 and 900 models at least). FlightDeck v1.04 
1440 dpi to follow. 


part of the British 
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special offer price - valid until] 31/3/2000. 
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This is the latest version of this popular route finding 
rogram. Find the quickest route or the shortest route 
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is available for this program. (see elsewhere in this advert). 
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these. On the QL-USERS mail 
list Someone posted a copy of 
his BOOT file because he was 
having a problem. As always 
on this list, there was no shor- 
tage of useful remarks about it. 
Amongst those was one which 
all users of Qubide and multiple 
partitions should note. Each 
partition takes up a sizeable 
chunk of RAM to store its map. 
lf you are in the habit of linking 
all of the partitions in when you 
start up, think again. You will be 
amazed at the amount of me- 
mory saved when only one 
WINi_ is active. You can always 
link more of them in with either 
a WIN_DRIVE command. or 
Winlink. 

Another point was made by 
Malcolm Cadman when talking 
about Mice and the QL. If you 
use some 3-button mice and 
think they don't work try 
holding the left mouse button 
down when firing it up. This will 
force the mouse to fire up as a 
three button mouse and not as 
a two button one. On my old 
SERmouse system this was vi- 
tal in order to stop the mouse 
streaking off into a corner and 
sulking there. | have the same 
problem with the Aurora sys- 
tem in the Q Branch HQ but not 
with the MinisQL both of which 
use the full superHermes. Diffe- 
rent mice - different techniques 
needed. 


This Gold’s on Fire 

Recent communications — bet- 
ween Nasta and us suggest 
that thinking about the Goldfire 
is reaching an advanced stage. 
One of his suggestions con- 
cerns the amount of RAM to be 
available and which form it 
should be in. My recent experi- 
ence with the Q 40 and ‘stan- 
dard’ PC items such as SIMMs 
suggests that there is no such 
thing as standard. the upper 
limit of the memory address- 
able by the GoldFire is 128Mb - 
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massive by QL standards ave- 
rage by the megalithic PC. You 
could have this on a ‘standard’ 
PC 168 pin DIMM or soldered 
directly onto the board. Since a 
128Mb DIMM refused to work 
with my graphics adaptor on 
my PC recently even though it 
worked fine with a_ different 
PC/Graphics Card | personally 
think that there is no contest. 
Find SDRAM which works and 
solder it directly onto the 
board. This does, however, 
raise one slight problem. The 
Q40's performance is held 
back slightly by the way in 
which the memory — slave 
blocks are handled. Users with 
32Mb as opposed to the stan- 
dard 16Mb supplied find a slight 
delay in the performance as it 
checks the extended slave 
blocks. What would this do to a 
128Mb memory | wonder? 

| think we would all rather 
splash out a few more pounds 
and have a large memory ca- 
pability on our systems and | 
think that there is no point in 
supplying lower memory units 
at a slightly lower cost. For 
once the capacity is not the 
issue here since ram chips 
themselves are comparatively 
cheap. Performance is_ what 
counts. We should, therefore 
look for ways around the slave 
block problem. Would it be fea- 
sible to specify an area and size 
for the slave blocks to use? 
These are mainly used when 
loading from disk so why not 
allow the user to specify how 
much ram should be allocated to 
slave block use. If you do a lot 
of shifting of data from disk you 
may want to increase this or, if 
you do not do much and tend to 
work on particular topics for 
long periods you could restrict it 
to a couple of Mb’s. | am no 
programmer so | am not sure if 
this is a feasible idea. 

Thierry was involved in the 
discussions about the GoldFire 


and, when the talk turned to 
the thorny problem of compati- 
bility with older games and pro- 
grams, suggested that anyone 
who bought the more advanced 
systems such as the GoldFire, 
QPC 2 and the Q 40 would not 
want to use these older pro- 
grams. | think | would differ 
here. | have already had people 
call me about running Abacus 
and Perfection of the Q 40 and 
about printing from Quill or 
Perfection from the QPC 2 
emulator It seems to me that 
people will always want to use 
the programs that they are the 
most familiar with and it is 
interesting to see people with 
500MHz PCs with all of the 
Micro$oft software on them 
wanting to use Quill This 
should tell programmers every- 
where something about simpli- 
city. | suppose they are not 
listening though because they 
are SO busy writing animated 
paper clips and other such 
nonsense. 

All the same the problem does 
remain that we have to some- 
times sacrifice advances in our 
system to take into account the 
way that older software exploi- 
ted loopholes in the old ROMs. 
People tell me that SMSQ/E is 
faulty because it will not run 
some of the old software with- 
out realising that the old soft- 
ware only ran because either 
the O/S did not see the errors 
in it or it was writing to an area 
which it was not supposed to 
but which was not being used 
at the time. There were areas in 
the JM and JS ROMS which 
were reserved for future use 
but never got exploited. Some 
of the old software used these 
areas and now, when the 
newer O/S comes along and 
uses these areas there are 
conflicts. It seems to the user 
that SMSQ/E is at fault but that 
is often (not always) the case. 
A recent bug fix for SMSQ/E 


QL foday 


(v2.95) actually made the situa- 
tion worse and some software 
crashed because of it. That 
should be fixed by now so 
upgrade immediately if you 
have older versions. 


Teaching a New Dos 
Old Tricks 


One of my shop customers, 
who runs the computer sys- 
tems in a local company, called 
in a while ago when | was run- 
ning up the first batch of the Q 
40s. He wants to write his own 
operating system and became 
fascinated by the simplicity and 
elegance of the Q 40's design. 
He immediately bought one of 
the first units and has been 
working with it for a while now. 
He is the first user who has not 
come from the QDOS/SMSQ 
direction and this is interesting 
for me because it tends to 
highlight the differences bet- 
ween our system and others. 
He was amazed by the con- 
cept that you could write a 
piece of code and add it to the 
system to generate new key- 
words and has been eagerly 
throwing himself into getting to 
grips with, what was to him, an 
alien system, Having been a QL 
user for over fifteen years | do 
tend to take some things for 
granted and | have had to think 
back a long way to get expla- 
nations about the way things 
work for us. | do not think that 
we will see any software from 
him although he is learning fast 
but | will keep you informed 
about his progress if you are 
interested. | may even be in a 
position to offer yet another 
O/S for the Q 40. 


LINUX 

As | mentioned above | have 
now got a functioning LINUX in- 
Stallation although time has 
been a little short recently so | 
have not done more than 
dipped my toe into the surface 
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of it. This seems to exist on 
two leveis and be perceived by 
people in two very opposite 
ways. One thing people seem 
to want more than anything 
else is a system which does 
not crash - understandable real- 
ly. If you talk to the average PC 
user they have perceived the 
hype about LINUX as ‘This is 
Windoze that Works’. Well that 
may be so or it may not. It is 
hard to tell this at this stage 
since | have not really got into 
using LINUX and there seem to 
be very few applications in the 
LINUX package so | suppose | 
will have to start raking the net 
for 68k LINUX programs. 
Purists and programmers 
eschew the X-Windows ap- 
proach and go for the com- 
mand line control. Since my 
knowledge of this is very limi 
ted | have not investigated it to 
any degree but, as | have said 
in this column before, | agree 
with Stuart Honeyball who 
thinks that computers should 
be accessible and understan- 
dable with very little reading or 
study. | suppose it all hinges on 
what you have a computer for 
lf you enjoy playing around with 
the system and programming 
then that is all well and good 
but the average user just 
wants to get on with the things 
he bought the machine for 
Typing out an essay at the 
command line is just not for him 
and that is why systems like 
Windoze took off in the first 
place. 


HTML 

There has been a lot of discus- 
sion on HTML in the QL-Users 
Internet group and in this issue 
of the magazine. | got involved 
in HTML a while ago when | re- 
wrote the DATAdesign manual 
when PROGS released Pro- 
WesS. It seemed to me to be 
the ideal tool for producing 
documentation because of its 


ability to allow the user to jump 
around the text. | am still not 
100% convinced that reading 
manuals onscreen is the best 
way to do it, however The 
more involved | get with PC 
software whose documenta- 
tion is almost exclusively in that 
format the more | feel that | do 
not get the full potential out of 
the programs. | would very 
often buy a new program and 
then sit down and read the 
manual for a while to get an 
idea of what it could and could 
not do. If you only have the 
manual as an online help 
source you will inevitably miss 
some of it’s potential. 


Adjust the Webbing 

Like many QLers now | have a 
PC sitting on my desk. | built it 
so that | could play a few 
games and as an_ Internet 
Station. In the second part of 
that | include maintaining my 
website. It is in that capacity 
that | come more involved with 
HTML. The PC abounds with 
programs to produce HTML 
There are loads of them. The 
abiding factor which distingul- 
shes them is that they nearly all 
produce absolute = rubbish 
HTML. Spurious tags abound 
and it seems that they put in 
stuff just to ensure that the 
resulting files are large enough 
to qualify as PC files. There are 
a couple of interesting ones — 
and, amazingly enough, these 
are both share or freeware. 
NotelabPro is shareware from 
Switzerland which does a good 
job and has lots of other uses 
and Evrsoft produce a free 
editor (ist Page 2000 

www.evrsoft.com/istpage/ - 
Steve Hail found this.) which is 
superb but these are PC pro- 
grams. Dilwyn and Geoff Wicks 
are both able to convert files 
from word processors into 
HTML but these, by their very 
nature, must produce restricted 
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code. We need someone to 
take on the task of writing a 
proper HTML writing tool for 
QDOS/SMSQ systems. | would 
imagine that the resulting edi- 
tor would not be an easy task 
because, to make it really use- 
ful it would have to be able to 
preview the results. 

The corporate vultures of big 
business do things like char- 
ging a high licence fee for 
people who want to use GIF 
image rendering and these 
things also need a lot of co- 
lours for them to work but JPG 
files are now a common inter- 
net picture form and Dave 
Westbury proved that a JPEG 
viewer iS a possibility so we 
should be able to do this. | 
would love to be able to pro- 
duce and edit my website on a 
QDOS/SMSQ system rather 
than on a PC. 


A Rolling Format 


Gathers Much Mess 

The big problem with HTML for 
us QLers is that it does not 
stay still The only two readers 
that we have for the QDOS/ 
SMSQ system are the PROGS 
one, supplied with ProWesS, 
which will only handle HTML 
3.00 or lower and QLynx - a PD 
HTML reader ported by Jona- 


than Hudson. | must confess 
that | have not tried to get 
QLynx working after a few 
abortive attempts a year or so 
ago but the whole process 
seemed unnecessarily com- 
plex. | do not, therefore, know if 
it can handle later versions of 
HTML. The kind of HTML that 
we meet on the internet today 
is of a much higher level and 
we desperately need a reader 
that can handle this if we are to 
proceed. The closeness of the 
release of the full colour drivers 
for SMSQ systems and the 
work being done TCP/IP stacks 
means that a full function HTML 
XTML viewer should be a prio- 
rity. Which leads me to this 
month's ..... 


Honourable & 
Mentions in 
& Dispatches 


As you may have seen in other 
places in the magazine PROGS 
have made the ProWesS base 
distribution free under the GPL 
licence. Joachim did this to 
encourage someone to use his 
HTML viewer, provided with it, 
as a base to produce a more 


up to date version. This does 
not mean that PROGS are 
quitting the QDOS/SMSQ 
world just that they are making 
their stuff more accessible 
which can only be a good 
thing. It requires a 'C’ program- 
mer and someone with a good 
knowledge of HTML to do it 
but we could wind up with a 
web browser. One of the main 
accusations levelled at Pro- 
WesS is that is a slow in 
comparison to other programs 
on our system but this is really 
a result using vector drawing 
techniques to produce the 
screens. AS we move more 
towards faster machines such 
as the Q 40, QPC 2 on fast PCs 
and the GoldFire ProWesS 
Should come more and more 
into the picture. Most people 
who move up to more powerful 
systems have a problem when 
using the higher resolutions 
because the size of the cha- 
racters makes it hard to read. 
Only programs like ProWesS 
can overcome this because 
the characters produced by 
these programs are vectored 
and not pixel based. We are 
planning to distribute the Pro- 
WesS base installation as a 
free cover disk in a later QL 
Today. Look out for it. 


You will find a little postcard with this issue. Please answer the questions on it and post it back to 
Jochen Merz Software. 
f you have used the CueDark screen saver system presented on the last cover disk, please take 
a few moments to look at the modules presented on this disk and vote for your favourite module 
to help us decide on a winner! Note that Thierry Gidefroy has asked that his modules are not 
entered into the competition, so please do not vote for him even if you preferred his modules! 


The card also asks you to tell us if your system can read HD disks, which will help us since it is 
| becoming harder for us to obtain DD disks now. 
| The final section lets you tell us what sorts of cover disk “themes” you'd like to see in the future. 


Please enter your name and email address. There is a small box you can tick if you would like to 
_ be added to the QL News Mailing List so that we can keep you informed about news and shows, 
especially QL shows in your area. 
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QL feday 


US QL 2000 Show 
Sponsored by NESQLUG “Wt 


| White River Junction, Vermont USA on May 20, 2000 
| The show will be held at the Hotel Coolidge in White River Junction, Vermont USA on | 
May 20, 2000. This small town is right on the border of the states of New Hampshire and 
Vermont in the heart of the US region known as New England. Close to major Interstate § 
Highways |-89 and I-91. 


The Hotel Coolidge has a web site http://www.hotelcoolidge.com/ and can be 

i contacted by email (hotel.coolidge@valley.net). There is also an 800 number that will | 
work within the US and Canada (800-622-1124) and a regular number (802-295-3118). If 

you Call please mention NESQLUG or QL Computer Show to get special rates: 

Single $49 Double $59 

| have reserved 8 rooms to be held until April 20th but will reserve more if we need them. 

All rooms are non smoking. The hotel has a restaurant and bar For those interested in the 

experience or on a tight budget will welcome travelers to stay in our home. Just let me 

know. 


| As in past years on Friday evening, May 19, at 6 PM we will meet in the hotel lobby and 
go to dinner together The show will be at the hotel from 10 AM until 4 PM on Saturday, 
May 20. A lunch will be served during the show. Admission to the show including lunch 
will be $12 per person but traders will be free. After the show there will be a dinner at the 
hotel which will be $20 per person. On the following day, May 21, there will be an all day 
gathering at our home, Bill Cable/Mary Boyle, for the day. It is located in Cornish, New 
Hampshire which is about 15 miles from the Hotel Coolidge. See the Wood And Wind 

| Wind Generator in action. 


Please contact: Bill Cable Director of NESQLUG at cable@cyberportal.netor (603) 675-2218 
if you have any questions. The Hotel Coolidge Web Site has a map and more detailed 
maps and directions will soon be available at the NESQLUG Web Site. If you are planning 
to come please let me know so we can keep an accurate list of who will be there. Hope 
to see you there. 


| Airport Driving Time to Show Location 


Boston, MA Airport 3 hour drive north 

a Manchester, NH Airport 11/2 hour drive north Nice Drive 

Hartford, CT Airport 3 hour drive northeast 

Burlington, VT Airport 2 hour drive east Nice Drive 

| Montreal, Canada Airport 4 hour drive south Nice Drive 
New York, NY Airports 6 hour drive northeast 

© Lebanon, NH Airport 10 minutes drive 

| this is small regional airport has rental cars 


The QL Show Agenda | 


/ 16. April - Davyhulme, Cnited Kingdom 
| NEMQLUGG Workshop & Quanta AGM 


| 13. May Eindhoven, The Netherlands 
| St. Joris College, same venue as always. 


20. May East Coast US Show. See reverse side! 
Planned for September: Italian QL Show. 

| Planned beginning of October: Austrian QL Show. 
14./15. October: QL 2000 Show (see below). 


Roy Brereton informs us, that the Guanta apodseel big two day QL2000 
workshop style meeting is set for Saturday and Sunday, October 14 and 
15. The venue is: 

The Horizon Center, Sundridge Close, Cosham, Portsmouth, PO6 3LP. 

| Cosham is a northern suburb of Portsmouth. Roy is the Quanta point- 
of-contact. At this moment he is sorting out the various hotels to find the 
| best deals. Overseas groups are being especially invited to come to this 
show. Saturday will be a trading day with several QL notables making 
presentations. Evening will see a group dinner, subsidized for Quanta 
members. On Sunday at 10:00 AM there will be a debate to discuss the 
| future of Quanta. At noon normal workshop activities/trading will con- 
tinue. 

At least 16 people from the US have expressed interest in coming. 
| NESQLUG has appointed Al Boehm as point-of-contact. Al is collecting 
travel information and any potential attendee from North America is 
encouraged to contact him: boehm @ziplink.net 

or Mail: 2501 Ermine Dr., Huntsville, Alabama 35810, GSA. 
”"Everything” about Portsmouth can be found at: 
http:/www.portsmouth-college.ac.uk/johnsite/Local.htm 


